Skip to content
This repository has been archived by the owner on Sep 21, 2021. It is now read-only.

Latest commit

 

History

History
41 lines (27 loc) · 1.48 KB

30_Root_Object.asciidoc

File metadata and controls

41 lines (27 loc) · 1.48 KB
Raw

The Root Object

The uppermost level of a mapping is known as the root object. It may contain the following:

  • A properties section, which lists the mapping for each field that a document may contain

  • Various metadata fields, all of which start with an underscore, such as _type, _id, and _source

  • Settings, which control how the dynamic detection of new fields is handled, such as analyzer, dynamic_date_formats, and dynamic_templates

  • Other settings, which can be applied both to the root object and to fields of type object, such as enabled, dynamic, and include_in_all

Properties

We have already discussed the three most important settings for document fields or properties in [core-fields] and [complex-core-fields]:

type

The datatype that the field contains, such as string or date

index

Whether a field should be searchable as full text (analyzed), searchable as an exact value (not_analyzed), or not searchable at all (no)

analyzer

Which analyzer to use for a full-text field, both at index time and at search time

We will discuss other field types such as ip, geo_point, and geo_shape in the appropriate sections later in the book.