2015-08-06 11:24:29 -04:00
|
|
|
[[dynamic-mapping]]
|
2013-08-28 19:24:34 -04:00
|
|
|
== Dynamic Mapping
|
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
One of the most important features of Elasticsearch is that it tries to get
|
|
|
|
out of your way and let you start exploring your data as quickly as possible.
|
|
|
|
To index a document, you don't have to first create an index, define a mapping
|
|
|
|
type, and define your fields -- you can just index a document and the index,
|
|
|
|
type, and fields will spring to life automatically:
|
2013-08-28 19:24:34 -04:00
|
|
|
|
|
|
|
[source,js]
|
|
|
|
--------------------------------------------------
|
2015-08-06 11:24:29 -04:00
|
|
|
PUT data/counters/1 <1>
|
|
|
|
{ "count": 5 }
|
2013-08-28 19:24:34 -04:00
|
|
|
--------------------------------------------------
|
2015-08-06 11:24:29 -04:00
|
|
|
// AUTOSENSE
|
|
|
|
<1> Creates the `data` index, the `counters` mapping type, and a field
|
|
|
|
called `count` with datatype `long`.
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
The automatic detection and addition of new types and fields is called
|
|
|
|
_dynamic mapping_. The dynamic mapping rules can be customised to suit your
|
|
|
|
purposes with:
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
<<default-mapping,`_default_` mapping>>::
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
Configure the base mapping to be used for new mapping types.
|
2013-10-10 14:17:49 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
<<dynamic-field-mapping,Dynamic field mappings>>::
|
2013-10-10 14:17:49 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
The rules governing dynamic field detection.
|
|
|
|
|
|
|
|
<<dynamic-templates,Dynamic templates>>::
|
2013-10-10 14:17:49 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
Custom rules to configure the mapping for dynamically added fields.
|
|
|
|
|
|
|
|
TIP: <<indices-templates,Index templates>> allow you to configure the default
|
2015-12-22 11:08:35 -05:00
|
|
|
mappings, settings and aliases for new indices, whether created
|
2015-08-06 11:24:29 -04:00
|
|
|
automatically or explicitly.
|
|
|
|
|
|
|
|
|
|
|
|
[float]
|
|
|
|
=== Disabling automatic type creation
|
|
|
|
|
|
|
|
Automatic type creation can be disabled by setting the `index.mapper.dynamic`
|
|
|
|
setting to `false`, either by setting the default value in the
|
|
|
|
`config/elasticsearch.yml` file, or per-index as an index setting:
|
2013-08-28 19:24:34 -04:00
|
|
|
|
|
|
|
[source,js]
|
|
|
|
--------------------------------------------------
|
2016-04-29 10:42:03 -04:00
|
|
|
PUT data/_settings <1>
|
2013-08-28 19:24:34 -04:00
|
|
|
{
|
2015-08-06 11:24:29 -04:00
|
|
|
"index.mapper.dynamic":false
|
2013-08-28 19:24:34 -04:00
|
|
|
}
|
|
|
|
--------------------------------------------------
|
2015-08-06 11:24:29 -04:00
|
|
|
// AUTOSENSE
|
2016-04-29 10:42:03 -04:00
|
|
|
// TEST[continued]
|
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
<1> Disable automatic type creation for all indices.
|
2014-07-18 16:50:07 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
Regardless of the value of this setting, types can still be added explicitly
|
|
|
|
when <<indices-create-index,creating an index>> or with the
|
|
|
|
<<indices-put-mapping,PUT mapping>> API.
|
|
|
|
|
|
|
|
|
|
|
|
include::dynamic/default-mapping.asciidoc[]
|
|
|
|
|
|
|
|
include::dynamic/field-mapping.asciidoc[]
|
2014-07-18 16:50:07 -04:00
|
|
|
|
2015-08-06 11:24:29 -04:00
|
|
|
include::dynamic/templates.asciidoc[]
|