Elasticsearch 参考指南（映射）

映射

映射是定义文档及其包含的字段如何存储和索引的过程，例如，使用映射来定义：

• 哪些字符串字段应该被视为全文字段。
• 哪些字段包含数字、日期或地理位置。
• 日期值的格式。
• 用于控制动态添加字段的映射的自定义规则。

映射类型

每个索引都有一个映射类型，它决定文档将如何被索引。

映射类型具有：

元字段

• 元字段用于自定义如何处理文档的关联元数据，元字段的示例包括文档的_index、_type、_id和_source字段。

字段或属性

• 映射类型包含与文档相关的字段或属性列表。

字段数据类型

每个字段都有一个数据type：

• 简单的类型，如text、keyword、date、long、double、boolean或ip。
• 支持JSON的层次结构的类型，如object或nested。
• 或者像geo_point、geo_shape或completion这样的特殊类型。

为不同的目的以不同的方式索引相同的字段通常是有用的，例如，字符串字段可以作为全文搜索的text字段索引，也可以作为排序或聚合的keyword字段索引，或者，你可以使用标准分析器、英语分析器和法语分析器索引字符串字段。

这就是多字段的目的，大多数数据类型通过fields参数支持多字段。

防止映射爆炸的设置

在索引中定义太多字段会导致映射爆炸，这会导致内存不足和难以恢复的情况，这个问题可能比预期的要普遍。例如，考虑这样一种情况，其中插入的每个新文档都引入了新字段，这在动态映射中非常常见，每当文档包含新字段时，这些字段就会出现在索引的映射中。这对于少量数据来说并不令人担心，但是随着映射的增长，这可能会成为一个问题，以下设置允许你限制可以手动或动态创建的字段映射的数量，以防止错误的文档导致映射爆炸：

index.mapping.total_fields.limit

• 索引中字段的最大数目，字段和对象映射以及字段别名都属于此限制，默认值是1000。

index.mapping.depth.limit

• 字段的最大深度，用内部对象的数量来度量，例如，如果所有字段都在根对象级别定义，则深度为1，如果有一个对象映射，则深度为2，依此类推，默认值是20。

index.mapping.nested_fields.limit

• 索引中不同嵌套映射的最大数目，默认为50。

index.mapping.nested_objects.limit

• 跨所有嵌套类型的单个文档中嵌套JSON对象的最大数量，默认为10000。

index.mapping.field_name_length.limit

• 设置字段名称的最大长度，默认值是Long.MAX_VALUE（没有限制），这个设置实际上并没有解决映射爆炸的问题，但是如果你想限制字段长度，那么它仍然是有用的，通常不需要设置这个设置，默认值没有问题，除非用户开始添加大量具有非常长的名称的字段。

动态映射

字段和映射类型在使用之前不需要定义，多亏了动态映射，新的字段名将自动添加，只需索引文档，可以向顶级映射类型、内部对象和嵌套字段添加新字段。

可以配置动态映射规则来定制用于新字段的映射。

显式的映射

你对数据的了解超过了Elasticsearch所能猜到的，因此，尽管开始动态映射可能很有用，但在某个时候，你可能希望指定自己的显式映射。

你可以在创建索引时创建字段映射，还可以使用PUT mapping API将字段添加到现有索引中。

更新现有字段映射

除非有文档记录，否则无法更新现有字段映射，更改映射将意味着已经索引的文档无效。相反，应该使用正确的映射创建一个新索引，并将数据重新索引到该索引中，如果只希望重命名字段而不更改其映射，那么引入别名字段可能是有意义的。

映射示例

可以在创建索引时指定映射，如下所示：

PUT my_index 
{
  "mappings": {
    "properties": { 
      "title":    { "type": "text"  }, 
      "name":     { "type": "text"  }, 
      "age":      { "type": "integer" },  
      "created":  {
        "type":   "date", 
        "format": "strict_date_optional_time||epoch_millis"
      }
    }
  }
}

• 创建一个名为my_index的索引。
• 指定映射中的字段或属性。
• 指定title字段包含text值。
• 指定name字段包含text值。
• 指定age字段包含integer值。
• 指定created字段包含两种可能格式的date值。

---