elasticsearch/docs/reference/mapping
Luca Cavanna d45b19db18
Add support for dots in field names for metrics usecases (#86166)
This PR adds support for a new mapping parameter to the configuration of the object mapper (root as well as individual fields), that makes it possible to store metrics data where it's common to have fields with dots in their names in the following format:

```
{
  "metrics.time" : 10,
  "metrics.time.min" : 1,
  "metrics.time.max" : 500
}
```

Instead of expanding dotted paths the their corresponding object structure, objects can be configured to preserve dots in field names, in which case they can only hold leaf sub-fields and no further objects.

The mapping parameter is called subobjects and controls whether an object can hold other objects (defaults to true) or not. The following example shows how it can be configured in the mappings:

```
{
  "mappings" : {
    "properties" : {
      "metrics" : {
        "type" : "object", 
        "subobjects" : false
      }
    }
  }
}
```

Closes #63530
2022-05-17 16:34:39 +02:00
..
dynamic [DOCS] Update dynamic mapping docs to clarify supported match_mapping_type (#83274) 2022-02-01 10:37:27 -05:00
fields [DOCS] Custom routing for data streams 2021-11-10 07:11:50 -06:00
params Add support for dots in field names for metrics usecases (#86166) 2022-05-17 16:34:39 +02:00
types Add support for dots in field names for metrics usecases (#86166) 2022-05-17 16:34:39 +02:00
dynamic-mapping.asciidoc [DOCS] Clean up index template xrefs (#67264) 2021-01-11 12:38:09 -05:00
explicit-mapping.asciidoc [DOCS] Replace put with create or update in API names (#70330) 2021-03-15 14:49:44 -04:00
fields.asciidoc Support fetching _tier field value (#71379) 2021-04-08 11:41:52 -07:00
mapping-settings-limit.asciidoc [DOCS] Relocate index.mapping.dimension_fields.limit setting docs (#80964) 2021-11-23 14:51:28 -05:00
params.asciidoc Add support for dots in field names for metrics usecases (#86166) 2022-05-17 16:34:39 +02:00
removal_of_types.asciidoc [DOCS] Fix double spaces (#71082) 2021-03-31 09:57:47 -04:00
runtime.asciidoc Fix a linebreak (#86739) (#86742) 2022-05-12 11:04:57 -04:00
types.asciidoc Clarify docs on field type families (#84368) 2022-02-24 13:27:36 -08:00