elasticsearch中动态模板全解实战

参考：https://www.phpmianshi.com/?id=169

动态模板

 

在我们最开始使用ES的时候，可能还不太了解mapping，也没有添加过mapping为什么我们还是能够正常的添加文档。

那是因为ES可以动态映射，添加文档的时候遇到没有的字段，可以动态的添加到mapping中

动态模板，英文名为Dynamic Templates，是根据Elasticsearch可识别的数据类型，结合字段名称，来动态设定字段类型的一种机制。

自动识别规则

首先es可以自动识别文档字段的类型，这样可以降低用户的使用成本。

es是依靠json文档的字段类型来实现自动识别字段类型的：

json类型 ：es类型

null  ： 忽略

boolean : boolean

浮点 ： float

整数 :   long

object : object

array : 第一个非null值类型决定

string : 匹配为日志则是date类型（默认开启），匹配为数字的话自动为 float或long类型（默认关闭），否则为text类型，附带keyword子字段

 

自定义动态模板

1、 根据字段类型mapping

根据字段类型匹配通过 match_mapping_type 属性来控制，当添加文档的时候，ES的JsonParser解析出来的类型是match_mapping_type指定的类型，就会使用对应的mapping

{
    "mappings": {
        "dynamic_templates": [
            {
                "name_one": {
                    "match_mapping_type": "long",
                    "mapping": {
                        "type": "integer"
                    }
                }
            },
            {
                "name_two": {
                    "match_mapping_type": "string",
                    "mapping": {
                        "type": "text",
                        "fields": {
                            "raw": {
                                "type": "keyword",
                                "ignore_above": 256
                            }
                        }
                    }
                }
            }
        ]
    }}

2、 根据字段名称mapping

根据字段名称映射使用的是 match、unmatch、match_pattern 属性来控制。

{
    "mappings": {
        "dynamic_templates": [
            {
                "longs_as_strings": {
                    "match_mapping_type": "string",
                    "match": "long_*",
                    "unmatch": "*_text",
                    "mapping": {
                        "type": "long",
                        "enable": false
                    }
                }
            },
            {
                "longs_as_strings": {
                    "match_pattern": "regex",
                    "match": "^profit_\\d+$",
                    "mapping": {
                        "type": "long",
                        "index": false,
                        "norms": false,
                        "doc_values": false
                    }
                }
            }
        ]
    }}

3、根据字段路径mapping

按路径匹配使用的是 path_match、path_unmatch 属性来指定。

{
    "mappings": {
        "dynamic_templates": [
            {
                "path_name": {
                    "path_unmatch": "user.*",
                    "path_match": "*.conceal",
                    "mapping": {
                        "type": "text",
                        "enable": false
                    }
                }
            }
        ]
    }}

动态mapping的添加方式

添加动态索引有2种方式：
第一种就是为索引添加mapping的时候同时指定动态映射的mapping。
第二种就是在索引模板中指定。

 

下面我们就来看一下在设置索引模板的时候指定。

 

 

索引模板

索引模板，英文名为Index Template。它是一种机制，这种机制允许我们定义一种模板，这种模板当新索引创建时将被自动应用。模板包含settings和mapping，以及这个模板是否可被应用于新的索引。

 

索引模板有以下限制：

1. 索引模板仅在一个索引新创建时才起作用，修改模板不会影响已创建的索引。

2. 可以设定多个索引模板，这些索引模板的设置将被merge在一起。

3. 可以通过对索引模板指定order的数值，来控制merge的过程。

模板定义可以如下：

{
  "order": 0,                // 模板优先级，数字越大优先级越高
  "index_patterns": ["test*,user*"],     // 匹配该模板的索引名称正则
  "settings": {},              // 索引设置
  "mappings": {},              // 索引中各字段的映射定义
  "aliases": {}               // 索引的别名
}

order：当索引名称匹配到多个索引模板的时候，换选择order值大的

模板优先级：

1.应用Elasticsearch默认的settings和mappings。

2.应用 order 数值低的索引模板中的设置。

3.应用 order 数值高的索引模板中的设置

4.应用索引创建时，用户指定的settings和mappings

index_patterns:索引名称匹配表达式，例如，所用以名称以test开头的都可以匹配到test*
settings：索引配置

mappings:默认的mapping

 

# 创建一个默认模板，模板名为 template_default
# 这个模板匹配所有的索引，它的order属性值为0。索引创建时将被设置一个分片，一个副本。
PUT _template/template_default
{
  "index_patterns": ["*"],
  "order" : 0,
  "version": 1,
  "settings": {
    "number_of_shards": 1,
    "number_of_replicas":1
  }
}
 
# 创建一个模板，模板名为 template_test
# 这个模板匹配test开头的索引，它的order属性值为1。索引创建时将被设置一个分片，两个副本。
# 并且，date类型自动检测功能将关闭，数字自动检测功能将开启。
PUT /_template/template_test
{
    "index_patterns" : ["test*"],
    "order" : 1,
    "settings" : {
        "number_of_shards": 1,
        "number_of_replicas" : 2
    },
    "mappings" : {
        "date_detection": false,
        "numeric_detection": true
    }
}
 
# 删除模板名为template_1的模板
DELETE /_template/template_1
 
# 获取模板名为template_1的模板
GET /_template/template_1
 
# 获取通配符模板
GET /_template/temp*
 
# 获取多个模板
GET /_template/template_1,template_2
 
# 获取所有模板
GET /_template
 
# 判断模板是否存在
HEAD _template/template_1