enabled（開啟字段） · Elasticsearch 5.4 中文文檔

# enabled（開啟字段）原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/getting-started.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/getting-started.html)（修改該鏈接為官網對應的鏈接）譯文鏈接 : [http://www.apache.wiki/display/Elasticsearch](http://www.apache.wiki/display/Elasticsearch)（修改該鏈接為 **ApacheCN** 對應的譯文鏈接）貢獻者 : @您的名字，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) **Elasticsearch** 嘗試著索引所有你提供的字段,但是有時候你只想要存儲這個字段而不需要索引.例如,假設你正在使用?**Elasticsearch** 作為?**web session?**的存儲.你可能想要索引**?session ID?**和最后一次更新時間,但不需要在?**session**?數據本身上查詢或運行聚合。 **enabled** 設置只可以應用于映射類型和?**[object](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/object.html)**?字段,導致?**Elasticsearch**?完全跳過字段內容的解析.這個?**JSON** 仍然可以從?**[_source](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/mapping-source-field.html)**?字段中檢索,但是不能以任何其他方式搜索或存儲： ``` curl -XPUT 'localhost:9200/my_index?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "session": { "properties": { "user_id": { "type": "keyword" }, "last_updated": { "type": "date" }, "session_data": { # 1 "enabled": false } } } } } ' curl -XPUT 'localhost:9200/my_index/session/session_1?pretty' -H 'Content-Type: application/json' -d' { "user_id": "kimchy", "session_data": { # 2 "arbitrary_object": { "some_array": [ "foo", "bar", { "baz": 2 } ] } }, "last_updated": "2015-12-06T18:20:22" } ' curl -XPUT 'localhost:9200/my_index/session/session_2?pretty' -H 'Content-Type: application/json' -d' { "user_id": "jpountz", "session_data": "none", # 3 "last_updated": "2015-12-06T18:22:13" } ' ``` | 1 | session_data 被禁用 | ? | | 2 | 任何數據都可以傳遞給 session_data 字段,因為它將完全被忽略 | ? | | 3 | session_data 會忽略不是JSON對象的值. | ? | 整個映射類型也可以被禁用,在這種情況下, document 存儲在_source字段中.這意味著它可以被檢索，但是它的內容沒有以任何方式被索引： ``` curl -XPUT 'localhost:9200/my_index?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "session": { # 1 "enabled": false } } } ' curl -XPUT 'localhost:9200/my_index/session/session_1?pretty' -H 'Content-Type: application/json' -d' { "user_id": "kimchy", "session_data": { "arbitrary_object": { "some_array": [ "foo", "bar", { "baz": 2 } ] } }, "last_updated": "2015-12-06T18:20:22" } ' curl -XGET 'localhost:9200/my_index/session/session_1?pretty' # 2 curl -XGET 'localhost:9200/my_index/_mapping?pretty' # 3 ``` | 1 | 完整的 session 映射類型被禁用 | | 2 | **document** 可以被檢索 | | 3 | 檢查映射確定沒有字段被添加 | 建議 enabled 設置允許在同一索引中相同名稱的字段有不同設置。可以使用?**[PUT mapping API](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/indices-put-mapping.html "Put Mapping")?**在現有字段上更新已經存在字段的值。