在一个将被用于映射任何类型的基本mapping中,在创建索引时或者调用PUT mapping API时,我们可以通过添加一个名为_default_的映射类型来定制一个索引。
PUT my_index
{
"mappings": {
"_default_": { #1
"_all": {
"enabled": false
}
},
"user": {}, #2
"blogpost": { #3
"_all": {
"enabled": true
}
}
}}
| 1 | 在mapping的_default_中,将_all字段设置为禁用,该mapping中的所有类型的_all字段默认为禁用。 | | 2 | user类型从_default_中继承相关设置。 | | 3 | blogpost类型覆盖相关默认值,并且启用_all字段。 |
Tips
当使用PUT mapping API更新mapping的_default_时,新的mapping不会与现有的mapping合并。相反,新的mapping的_defalut_会替换现有的。
虽然mapping的_default_可以在索引创建后更新,但是新的默认值只会影响之后创建的映射类型。
mapping中的_default_可以与索引模板一起使用,用来控制自动创建的索引中动态创建的类型。
PUT _template/logging
{
"template": "logs-*", #1
"settings": { "number_of_shards": 1 }, #2
"mappings": {
"_default_": {
"_all": { #3
"enabled": false
},
"dynamic_templates": [
{
"strings": { #4
"match_mapping_type": "string",
"mapping": {
"type": "text",
"fields": {
"raw": {
"type": "keyword",
"ignore_above": 256
}
}
}
}
}
]
}
}}
PUT logs-2015.10.01/event/1{ "message": "error:16" }
| 1 | logging模板将匹配以logs-开头的任何索引。 | | 2 | 匹配的索引将会创建单个主分片。 | | 3 | 在新的映射类型中,_all字段将会被默认禁用。 | | 4 | 字符串字段将会被创建到名为text的主字段和一个 keyword.raw字段中。 |