NOTE: You are looking at documentation for an older release. For the latest information, see the current release documentation.
enabled
editenabled
editElasticsearch tries to index all of the fields you give it, but sometimes you want to just store the field without indexing it. For instance, imagine that you are using Elasticsearch as a web session store. You may want to index the session ID and last update time, but you don’t need to query or run aggregations on the session data itself.
The enabled
setting, which can be applied only to the mapping type and to
object
fields, causes Elasticsearch to skip parsing of the
contents of the field entirely. The JSON can still be retrieved from the
_source
field, but it is not searchable or stored
in any other way:
PUT my_index { "mappings": { "_doc": { "properties": { "user_id": { "type": "keyword" }, "last_updated": { "type": "date" }, "session_data": { "enabled": false } } } } } PUT my_index/_doc/session_1 { "user_id": "kimchy", "session_data": { "arbitrary_object": { "some_array": [ "foo", "bar", { "baz": 2 } ] } }, "last_updated": "2015-12-06T18:20:22" } PUT my_index/_doc/session_2 { "user_id": "jpountz", "session_data": "none", "last_updated": "2015-12-06T18:22:13" }
The |
|
Any arbitrary data can be passed to the |
|
The |
The entire mapping type may be disabled as well, in which case the document is
stored in the _source
field, which means it can be
retrieved, but none of its contents are indexed in any way:
PUT my_index { "mappings": { "_doc": { "enabled": false } } } PUT my_index/_doc/session_1 { "user_id": "kimchy", "session_data": { "arbitrary_object": { "some_array": [ "foo", "bar", { "baz": 2 } ] } }, "last_updated": "2015-12-06T18:20:22" } GET my_index/_doc/session_1 GET my_index/_mapping
The entire |
|
The document can be retrieved. |
|
Checking the mapping reveals that no fields have been added. |
The enabled
setting for existing fields and the top-level mapping
definition cannot be updated.