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, 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
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
stringordate 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
analyzerto 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.