Mapping是用来定义一个文档(document),以及它所包含的属性(field)是如何存储和索引的。比如,使用mapping来定义:
哪些字符串属性应该被看做全文本属性(full text fields)。
哪些属性包含数字,日期或者地理位置。
文档中的所有属性是否都能被索引(_all 配置)。
日期的格式。
自定义映射规则来执行动态添加属性。
每一个索引都有一个或多个映射类型,用于在一个索引中把文档划分为具有逻辑关系的分组。比如,用户文档应该存储为user 类型,博客应该放置于blogpost类型下。
每一个映射类型包含:
Meta_fields(元标签)
元标签用于制定如何处理文档相关的元数据。例如元标签包含文档的_index, _type, _id, 和 _source字段。
Fields or properties(字段或属性)
每一个映射类型包含有一些与该类型相关的字段或者属性。比如一个user类型也许包含title,name,age属性,而blogpost类型也许包含title, body, user_id 和 created属性。在同一索引中,不同的映射类型下具有相同名称的属性具有相同的映射。
每一个属性都有一个数据类型:
根据不同的目的以不同的方式索引同一字段往往是有用的,例如,一个字符串字段可以作为全文本搜索的文本字段进行索引,也可以作为排序或者聚合的关键字来进行索引。另外,你可以通过标准分词,英文分词以及法文分词来索引一个字符串。
这就是进行multi-fields的目的。大多数数据类型都能通过fields配置来支持multi-fields。
接下来的设置用于限制通过人为或者动态创建field映射的数量,为了防止bad文档引起mapping explosion。
index.mapping.total_fields.limit
一个索引中的字段/属性的最大数量,默认为1000.
index.mapping.depth.limit
一个字段/属性的最大深度,用于控制内部对象的数量。例如,如果所有的字段/属性都定义为root对象级别,那么深度就为1。如果有一个对象映射,那么深度为2。默认值为20。
index.mapping.nested_fields.limit
一个索引中嵌套字段/属性的最大值,默认为50。用100个嵌套字段索引1个文档实际上相当于索引了101个文档,因为每个嵌套文档都会作为单独的隐藏文档被索引。
字段和映射在被使用前是不需要定义的。可以通过索引一个文档来自动添加新的映射和字段名。可以向顶层映射类型和内部对象以及嵌套字段中添加新的字段。
通过配置动态映射规则来定制映射,用于新的类型和字段。
你可以在创建索引的时候创建映射类型和字段映射,并且你可以通过PUT mapping API添加映射类型和字段到一个已经存在的索引中。
除了已经存在的文档之外,存在的类型和字段映射不能被更新。改变映射意味着让已经索引的文档失效。相反,你应该使用正确的映射以及重新索引数据来创建新的索引。
映射类型用于给字段分组,但是每个映射类型中的字段不是相互独立的。以下情况下的字段具有相同的映射。
如果title字段同时存在于user和blogpost映射类型中,那么title字段在每个类型中都有相同的映射。除了copy_to, dynamic, enabled, ignore_above, include_in_all, 和 properties,这些属性在每个字段中可能会有不同的设置。
通常,具有相同名称的字段也包含同样的数据类型,所以具有相同的映射不是问题。通过选择更多的描述名称能够解决冲突,如user_title
和blog_title.
可以在创建索引的时候指定映射:
curl -XPUT 'localhost:9200/my_index?pretty' -H 'Content-Type: application/json' -d'
{
"mappings": {
"user": {
"_all": { "enabled": false },
"properties": {
"title": { "type": "text" },
"name": { "type": "text" },
"age": { "type": "integer" }
}
},
"blogpost": {
"_all": { "enabled": false },
"properties": {
"title": { "type": "text" },
"body": { "type": "text" },
"user_id": {
"type": "keyword"
},
"created": {
"type": "date",
"format": "strict_date_optional_time||epoch_millis"
}
}
}
}
}
'