ElasticSearch 动态模板使用方法原创

# ElasticSearch 动态模板使用方法

# 1. 什么是动态模板

动态模板（Dynamic Templates）是 Elasticsearch 中的一种功能，用于在文档插入时根据字段的名称、数据类型或路径自动应用特定的映射。它允许用户在不预先定义字段映射的情况下，自动将新字段映射为特定的类型或配置。

# 2. 动态模板的作用

动态模板主要有以下作用：

简化索引创建：无需提前定义所有字段，可以动态生成映射。
提高灵活性：可以根据字段名、数据类型等条件灵活应用不同的映射规则。
自动管理字段：自动设置字段类型、分词器等属性。

# 3. 动态模板的使用步骤

# 3.1 创建索引并定义动态模板

在创建索引时，可以在 mappings 部分定义 dynamic_templates，例如：

PUT /my_index
{
  "mappings": {
    "dynamic_templates": [
      {
        "strings_as_keywords": {
          "match_mapping_type": "string",
          "mapping": {
            "type": "keyword"
          }
        }
      },
      {
        "long_fields": {
          "match_mapping_type": "long",
          "mapping": {
            "type": "long"
          }
        }
      },
      {
        "custom_template": {
          "match": "custom_*",
          "mapping": {
            "type": "text",
            "analyzer": "custom_analyzer"
          }
        }
      }
    ]
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

在这个示例中，我们定义了三个动态模板：

strings_as_keywords：将所有字符串类型的字段映射为 keyword 类型。
long_fields：将所有 long 类型的字段映射为 long 类型。
custom_template：将所有字段名匹配 custom_* 的字段映射为 text 类型，并使用 custom_analyzer 进行分析。

# 3.2 更新索引的动态模板

如果需要更新已有索引的动态模板，可以使用 PUT 请求更新映射：

PUT /my_index/_mapping
{
  "dynamic_templates": [
    {
      "updated_template": {
        "match": "new_field_*",
        "mapping": {
          "type": "text",
          "analyzer": "new_analyzer"
        }
      }
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 3.3 插入文档并验证

插入文档后，Elasticsearch 会根据动态模板自动应用映射：

POST /my_index/_doc
{
  "name": "John",
  "age": 30,
  "custom_field": "some text",
  "new_field_example": "another text"
}

1
2
3
4
5
6
7

使用 GET 请求查看映射：

GET /my_index/_mapping

可以看到动态模板已经被应用到相应的字段上。

# 4. 动态模板的匹配规则

动态模板的匹配规则主要包括以下几种：

match：根据字段名进行匹配，可以使用通配符。
unmatch：排除特定字段名。
match_mapping_type：根据字段的数据类型进行匹配。
path_match：根据字段的路径进行匹配。
path_unmatch：排除特定路径的字段。

# 5. 动态模板的优先级

当多个动态模板可以应用于同一字段时，Elasticsearch 按照定义顺序应用第一个匹配的模板。因此，定义动态模板时需要注意顺序，以确保正确的模板被应用。

# 6. 示例代码

以下是一个完整的示例代码，展示了如何使用动态模板：

PUT /my_index
{
  "mappings": {
    "dynamic_templates": [
      {
        "strings_as_keywords": {
          "match_mapping_type": "string",
          "mapping": {
            "type": "keyword"
          }
        }
      },
      {
        "long_fields": {
          "match_mapping_type": "long",
          "mapping": {
            "type": "long"
          }
        }
      },
      {
        "custom_template": {
          "match": "custom_*",
          "mapping": {
            "type": "text",
            "analyzer": "custom_analyzer"
          }
        }
      }
    ]
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

插入文档并验证：

POST /my_index/_doc
{
  "name": "John",
  "age": 30,
  "custom_field": "some text"
}

1
2
3
4
5
6

查询映射：

GET /my_index/_mapping

#动态模板 #mapping #索引管理 #数据类型 #ES配置

上次更新: 8/28/2024

← tcpdump抓包Elasticsearch语句 ES打开slowlog记录慢语句→

ElasticSearch 动态模板 使用方法原创