2013-08-28 19:24:34 -04:00
|
|
|
[[mapping-fields]]
|
2015-07-19 19:24:29 -04:00
|
|
|
== Meta-Fields
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-07-19 19:24:29 -04:00
|
|
|
Each document has metadata associated with it, such as the `_index`, mapping
|
|
|
|
<<mapping-type-field,`_type`>>, and `_id` meta-fields. The behaviour of some of these meta-fields
|
|
|
|
can be customised when a mapping type is created.
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
[float]
|
|
|
|
=== Identity meta-fields
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-07-19 19:24:29 -04:00
|
|
|
[horizontal]
|
|
|
|
<<mapping-index-field,`_index`>>::
|
|
|
|
|
|
|
|
The index to which the document belongs.
|
|
|
|
|
|
|
|
<<mapping-uid-field,`_uid`>>::
|
|
|
|
|
|
|
|
A composite field consisting of the `_type` and the `_id`.
|
|
|
|
|
|
|
|
<<mapping-type-field,`_type`>>::
|
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
The document's <<mapping-type,mapping type>>.
|
2015-07-19 19:24:29 -04:00
|
|
|
|
|
|
|
<<mapping-id-field,`_id`>>::
|
|
|
|
|
|
|
|
The document's ID.
|
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
[float]
|
|
|
|
=== Document source meta-fields
|
|
|
|
|
2015-07-19 19:24:29 -04:00
|
|
|
<<mapping-source-field,`_source`>>::
|
|
|
|
|
|
|
|
The original JSON representing the body of the document.
|
|
|
|
|
2015-08-15 12:00:55 -04:00
|
|
|
{plugins}/mapping-size.html[`_size`]::
|
2015-08-06 11:24:29 -04:00
|
|
|
|
2015-08-15 12:00:55 -04:00
|
|
|
The size of the `_source` field in bytes, provided by the
|
|
|
|
{plugins}/mapping-size.html[`mapper-size` plugin].
|
2015-08-06 11:24:29 -04:00
|
|
|
|
|
|
|
[float]
|
|
|
|
=== Indexing meta-fields
|
|
|
|
|
2015-07-19 19:24:29 -04:00
|
|
|
<<mapping-all-field,`_all`>>::
|
|
|
|
|
|
|
|
A _catch-all_ field that indexes the values of all other fields.
|
|
|
|
|
|
|
|
<<mapping-field-names-field,`_field_names`>>::
|
|
|
|
|
|
|
|
All fields in the document which contain non-null values.
|
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
<<mapping-timestamp-field,`_timestamp`>>::
|
|
|
|
|
|
|
|
A timestamp associated with the document, either specified manually or auto-generated.
|
|
|
|
|
|
|
|
<<mapping-ttl-field,`_ttl`>>::
|
|
|
|
|
|
|
|
How long a document should live before it is automatically deleted.
|
|
|
|
|
|
|
|
[float]
|
|
|
|
=== Routing meta-fields
|
|
|
|
|
2015-07-19 19:24:29 -04:00
|
|
|
<<mapping-parent-field,`_parent`>>::
|
|
|
|
|
|
|
|
Used to create a parent-child relationship between two mapping types.
|
|
|
|
|
|
|
|
<<mapping-routing-field,`_routing`>>::
|
|
|
|
|
|
|
|
A custom routing value which routes a document to a particular shard.
|
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
[float]
|
|
|
|
=== Other meta-field
|
2015-07-19 19:24:29 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
<<mapping-meta-field,`_meta`>>::
|
2015-07-19 19:24:29 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
Application specific metadata.
|
2015-07-19 19:24:29 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
include::fields/all-field.asciidoc[]
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
include::fields/field-names-field.asciidoc[]
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-07-19 19:24:29 -04:00
|
|
|
include::fields/id-field.asciidoc[]
|
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
include::fields/index-field.asciidoc[]
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
include::fields/meta-field.asciidoc[]
|
2014-05-20 11:34:00 -04:00
|
|
|
|
2015-07-19 19:24:29 -04:00
|
|
|
include::fields/parent-field.asciidoc[]
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-07-19 19:24:29 -04:00
|
|
|
include::fields/routing-field.asciidoc[]
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
include::fields/source-field.asciidoc[]
|
|
|
|
|
2013-08-28 19:24:34 -04:00
|
|
|
include::fields/timestamp-field.asciidoc[]
|
|
|
|
|
|
|
|
include::fields/ttl-field.asciidoc[]
|
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
include::fields/type-field.asciidoc[]
|
|
|
|
|
|
|
|
include::fields/uid-field.asciidoc[]
|
|
|
|
|