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
, anddynamic_templates
-
Other settings, which can be applied both to the root object and to fields of type
object
, such asenabled
,dynamic
, andinclude_in_all
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
ordate
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.