default mapping(mapping中的_default_)

在一个将被用于映射任何类型的基本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字段中。 |