elasticsearch/docs/reference/mapping/fields.asciidoc
Julie Tibshirani 3da738e5db
Support fetching _tier field value (#71379)
Now that the `fields` option allows fetching metadata fields, we can support
loading the new `_tier` metadata field.

Relates to #63569 and #68135.
2021-04-08 11:41:52 -07:00

85 lines
1.9 KiB
Text

[[mapping-fields]]
== Metadata fields
Each document has metadata associated with it, such as the `_index`
and `_id` metadata fields. The behavior of some of these metadata
fields can be customized when a mapping is created.
[discrete]
=== Identity metadata fields
[horizontal]
<<mapping-index-field,`_index`>>::
The index to which the document belongs.
<<mapping-id-field,`_id`>>::
The document's ID.
[discrete]
=== Document source metadata fields
<<mapping-source-field,`_source`>>::
The original JSON representing the body of the document.
{plugins}/mapper-size.html[`_size`]::
The size of the `_source` field in bytes, provided by the
{plugins}/mapper-size.html[`mapper-size` plugin].
[discrete]
=== Doc count metadata field
<<mapping-doc-count-field,`_doc_count`>>::
A custom field used for storing doc counts when a document represents pre-aggregated data.
[discrete]
=== Indexing metadata fields
<<mapping-field-names-field,`_field_names`>>::
All fields in the document which contain non-null values.
<<mapping-ignored-field,`_ignored`>>::
All fields in the document that have been ignored at index time because of
<<ignore-malformed,`ignore_malformed`>>.
[discrete]
=== Routing metadata field
<<mapping-routing-field,`_routing`>>::
A custom routing value which routes a document to a particular shard.
[discrete]
=== Other metadata field
<<mapping-meta-field,`_meta`>>::
Application specific metadata.
<<mapping-tier-field,`_tier`>>::
The current data tier preference of the index to which the document belongs.
include::fields/doc-count-field.asciidoc[]
include::fields/field-names-field.asciidoc[]
include::fields/ignored-field.asciidoc[]
include::fields/id-field.asciidoc[]
include::fields/index-field.asciidoc[]
include::fields/meta-field.asciidoc[]
include::fields/routing-field.asciidoc[]
include::fields/source-field.asciidoc[]
include::fields/tier-field.asciidoc[]