干货 | Elasticsearch基础但非常有用的功能之二：模板

小青春curry

发布于 2022-10-17 15:35

浏览

0收藏

1、引言

业务场景1：数据量非常大，需要进行索引生命周期管理，按日期划分索引，要求多个索引的Mapping一致，每次手动创建或者脚本创建都很麻烦！怎么破？

业务场景2：实际业务多个索引，想让多个索引中的相同名字的字段类型完全一致，以便实现跨索引检索。怎么破？

干货 | Elasticsearch基础但非常有用的功能之二：模板-鸿蒙开发者社区

思考上面两个问题，当单Mapping不能解决多索引问题时，模板的作用就体现出来了。

下文中：模板=template，映射=Mapping。

2、Elasticsearch模板是什么鬼？

【维基百科】模板：或称样板、范本，通常指具有固定内容、可构建多个不同实例的可重用样板。

Elasticsearch索引template指：在创建新索引时将自动套用的模板。

直接上样例，一探究竟。

 PUT _template/template_1
{
  "index_patterns": ["te*", "bar*"],
 "aliases" : {
        "alias1" : {}}
  "settings": {
    "number_of_shards": 1
  },
  "mappings": {
    "_source": {
      "enabled": false
    },
    "properties": {
      "host_name": {
        "type": "keyword"
      },
      "created_at": {
        "type": "date",
        "format": "EEE MMM dd HH:mm:ss Z yyyy"
      }
    }
  }
}

其中：
index_patterns代表匹配的索引。
settings 指索引层面的设置。
可以设置索引层面的配置，包括：

分片数（number_of_shards）、
副本数（number_of_replicas）、
刷新频率（refresh_interval）

…..

mappings：字段映射。

aliases：指定索引的别名。

别名的妙处参考：Elasticsearch基础但非常有用的功能之一：别名

3、Elasticsearch模板的基础操作

3.1 增

PUT _template/template_1

如第二节的示例。

3.2 删

DELETE /_template/template_1

3.3 改

直接执行3.1的创建模板操作，会生成相同名称的新的模板，并会覆盖掉原来创建的模板。

新模板只对新创建的索引生效，对历史索引不起作用。

3.4 查

GET /_template/template_1

4、Elasticsearch模板进阶实战

当template和Mapping的dynamic_templates结合就相当于放了大招。

直接拿个实战例子说明问题。

需求1：默认如果不显示指定Mapping，数值类型的值会被映射会long类型，但实际业务数值都比较小，会有存储浪费。需要将默认值改成integer。

需求2：date_*开头的字符统一匹配为date日期类型。

实战如下：

PUT sampleindex/_doc/1
{
  "Value":123
}

GET sampleindex/_mapping


PUT _template/sample_dynamic_template
{
  "index_patterns": [
    "sample*"
  ],
  "mappings": {
    "dynamic_templates": [
      {
        "handle_integers": {
          "match_mapping_type": "long",
          "mapping": {
            "type": "integer"
          }
        }
      },
      {
        "handle_date": {
          "match": "date_*",
          "unmatch": "*_text",
          "mapping": {
            "type": "date"
          }
        }
      }
    ]
  }
}

DELETE sampleindex
PUT sampleindex/_doc/1
{
  "Value":123,
  "date_curtime":"1574494620000"
}

GET sampleindex/_mapping

index_patterns：对应待匹配的以”sample开头的“索引。
handle_integers：动态模板的名字，你可以自己定义。
match_mapping_type：被匹配的被重写的源数据类型。
match/unmatch：匹配字段类型。

整个操作的核心是：将默认的long改成integer，date_*开头匹配为date类型。

更多分类如下：

干货 | Elasticsearch基础但非常有用的功能之二：模板-鸿蒙开发者社区

核心参见：

https://www.elastic.co/guide/en/elasticsearch/reference/current/dynamic-templates.html

不再赘述。

5、常见问题

问题1：template和Mapping到底什么区别？

Mapping：
针对单一索引。
类似Mysql中的表结构定义，是所有数据存储到该索引的架构定义。
字段支持：1）静态明确定义、2）系统层面自动识别、3）动态匹配。
template：
针对一个或多个索引。
除了定义Mapping的全支持外，还可以指定Setting、别名等。
适合数据量大、灵活多变的业务场景。

问题2：模板里可以指定Mapping，那我们还需要Mapping做什么？

索引模板对于在多个索引创建映射时非常有用。
如果数据量少，业务场景单一，那只Mapping也能解决问题。

问题3：如果我想更新Mapping，更新模板可以吗？

认知前提：Mapping一旦创建了，不能修改。除非进行reindex操作。

一旦创建了索引，对索引模板的更新将不会影响该索引。更新模板仅适用于新索引。
同样，更新为dynamic_templates仅会影响索引中的新字段。

问题4：模板order起到什么作用？

拿星球同学实战例子举例一下：

问题：我现在想创建2个template，其中模板B-template有副本设置，另外一个A-template没有副本设置，我可以这样配置吗？

其中B-template匹配到我单独设置的几个索引（"logstash-B-tomcat-","logstash-B1-tomcat-","logstash-B2-server-*","logstash-B3-tomcat"），
另外A-template匹配所有，我设置B-template的order比A-template高，是不是我那4个索引就会匹配到B-template呢？

正确写法参考：

PUT _template/b-template
{
  "order":1,
  "index_patterns":["logstash-b-tomcat-*","logstash-b1-tomcat-*","logstash-b2-server-*","logstash-b3-tomcat-*"],
  "settings":{
    "number_of_shards":"5",
    "number_of_replicas":"1",
    "refresh_interval":"30s",
    "translog.durability":"async"
  }
}

PUT logstash-b-tomcat-1

PUT _template/a-template
{
  "order":0,
  "index_patterns":["*"],
  "settings":{
    "number_of_shards":"5",
    "number_of_replicas":"0",
    "refresh_interval":"30s",
    "translog.durability":"async"
  }
}

核心原理：order高会覆盖order低的模板。