在业务系统中,遇到过两个问题:app
问题1:设置为keyword类型的字段,插入很长的大段内容后,报字符超出异常,没法插入。ide
问题2:检索超过ignore_above设定长度的字段后,没法返回结果。post
思考:Elasticsearch单字段支持的最大字符数?url
本文是基于设置ignore_above以后引伸的问题展开讨论与思考。插件
013d
ignore_above的做用?code
ES中用于设置超过设定字符后,不被索引或者存储。blog
Strings longer than the ignore_above setting will not be indexed or stored.排序
02索引
ignore_above用法
PUT ali_test
{
"mappings": {
"ali_type": { "properties": { "url": { "type":"keyword", "ignore_above":256 }, "url_long": { "type":"keyword" }, "url_long_long": { "type":"keyword", "ignore_above":32766 } } }
}
}
03
当字符超过给定长度后,可否存入?
验证表名,对于以上mapping中设置的url,url_long,url_long_long3个字段。超过256字符的url,均可以存入。
3.1 keyword类型,普通长度验证
插入url长度为:1705个字符,以下所示:
post ali_test/ali_type/1
{
"url" : "1705个字符的url"
}
url参考地址:http://t.cn/zH6FHG7
检索:
GET ali_test/ali_type/_search
{
"query": {
"term": {
"url" : "1705个字符的url"
}
}
}
返回结果:
{
"took": 1,
"timed_out": false,
"_shards": {
"total": 5, "successful": 5, "failed": 0
},
"hits": {
"total": 0, "max_score": null, "hits": []
}
}
结论:
1705个字符,url、url_long、url_long_long均可以存入,能够经过head插件查看结果。
可是url term检索没法检索返回结果,缘由: url字段设置了"ignore_above":256,致使超出256个字符后不被索引。
3.2 对于keyword类型,临界长度验证
post 32767个字符的文档,报错以下:
{
"error":{
"root_cause":[
{
"type":"illegal_argument_exception", "reason":"Document contains at least one immense term in field="url_long" (whose UTF8 encoding is longer than the max length 32766), all of which were skipped. Please correct the analyzer to not produce such terms. The prefix of the first immense term is: '[104, 116, 116, 112, 58, 47, 47, 119, 119, 119, 46, 103, 111, 111, 103, 108, 101, 46, 99, 111, 109, 47, 115, 101, 97, 114, 99, 104, 63, 104]...', original message: bytes can be at most 32766 in length; got 32767" } ], "caused_by":{ "type":"max_bytes_length_exceeded_exception", "reason":"max_bytes_length_exceeded_exception: bytes can be at most 32766 in length; got 32767" } }, "status":400
}
post 32766个字符后,能提交成功,返回结果以下:
{
"_index": "ali_test",
"_type": "ali_type",
"_id": "2000",
"_version": 1,
"result": "created",
"_shards": {
"total": 2, "successful": 2, "failed": 0
},
"created": true
}
结论:keyword类型的最大支持的长度为——32766个UTF-8类型的字符。
也就是说term精确匹配的最大支持的长度为32766个UTF-8个字符。
04
text类型和keyword类型的存储字符数区别?
text类型:支持分词、全文检索,不支持聚合、排序操做。适合大字段存储,如:文章详情、content字段等;
keyword类型:支持精确匹配,支持聚合、排序操做。适合精准字段匹配,如:url、name、title等字段。
通常状况,text和keyword共存,设置mapping以下:
{
"mappings": {
"ali_type": { "properties": { "title_v1": { "analyzer":"ik_max_word", "type":"text", "term_vector" : "with_positions_offsets", "fields":{ "keyword":{ "ignore_above":256, "type":"keyword" } } } } }
}
}
05
小结
1)ES5.X版本之后,keyword支持的最大长度为32766个UTF-8字符,text对字符长度没有限制。
2)设置ignore_above后,超过给定长度后的数据将不被索引,没法经过term精确匹配检索返回结果。
参考: