# ignore_above（忽略超越限制的字段） 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/ignore-above.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/ignore-above.html) 譯文鏈接 : [http://www.apache.wiki/pages/createpage-entervariables.action?templateId=4816898&spaceKey=Elasticsearch&title=&newSpaceKey=Elasticsearch&fromPageId=9405287](http://www.apache.wiki/pages/createpage-entervariables.action?templateId=4816898&spaceKey=Elasticsearch&title=&newSpaceKey=Elasticsearch&fromPageId=9405287) 貢獻者 : @您的名字，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) 字符串長度超過 **ignore_above** 設置的不會被索引和存儲. ``` curl -XPUT 'localhost:9200/my_index?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "my_type": { "properties": { "message": { "type": "keyword", "ignore_above": 20 # 1 } } } } } ' curl -XPUT 'localhost:9200/my_index/my_type/1?pretty' -H 'Content-Type: application/json' -d' # 2 { "message": "Syntax error" } ' curl -XPUT 'localhost:9200/my_index/my_type/2?pretty' -H 'Content-Type: application/json' -d' # 3 { "message": "Syntax error with some long stacktrace" } ' curl -XGET 'localhost:9200/_search?pretty' -H 'Content-Type: application/json' -d' # 4 { "aggs": { "messages": { "terms": { "field": "message" } } } } ``` | 1 | 字段會忽略超過20個字符的字符串. | | 2 | 這個 **document** 成功被索引. | | 3 | 這個 **document** 會被索引,但是不會索引 **message** 字段. | | 4 | 搜索返回兩個文檔,但只有第一個存在于 **terms**（詞條）聚合中. | tip **ignore_above** 設置允許在相同索引的相同名稱的字段有不同的配置,可以使用?[PUT mapping API](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/indices-put-mapping.html "Put Mapping")?在現有字段上更新其值。 此選項對于防止Lucene term（詞條）長度超過32766是有用的. **ignore_above?**的值是字符數，但?**Lucene?**計數的是字節。所以如果你使用具有許多非ASCII字符的UTF-8文本，則可能需要將限制設置為?**32766/3 = 10922**，因為UTF-8字符可能占用至多3個字節。