# Dynamic templates(动态模板)
动态模板允许你定义可以用于动态添加的字段的自定义映射：
* 由Elasticsearch中的match\_mapping\_type检测到数据类型。
* 字段的名称可以是match(匹配)和unmatch(不匹配)或match\_pattern(模式匹配)。
* 全点路径的字段可以是path\_match(路径匹配)和path\_unmatch(不匹配路径)。
原始字段名称{name}和检测导的数据类型{dynamic\_type}模板变量可以在映射规范中用作占位符。
> Tips
>
> 仅当字段包含具体值（不为空或空数组）时才添加动态字段映射。这意味着如果在dynamic\_template中使用null\_value选项，只能在该字段具有的具体值已被索引第一个文档之后才会应用该值。
动态模板是指定为命名对象的一个数组：
```
"dynamic_templates": [
{
"my_template_name": { # 1
... match conditions ... # 2
"mapping": { ... } # 3
}
},
...
]
```
| 1 | 模板名称可以是任意字符串。 |
| - | -------------------------------------------------------------------------------------------------------------------------------- |
| 2 | 匹配条件可以包括以下任何一种：match\_mapping\_type(匹配映射类型),match(匹配),match\_pattern(模式匹配),unmatch(不匹配),path\_match(路径匹配),path\_unmatch(取消路径匹配)。 |
| 3 | 匹配字段应该使用的映射。 |
模板按顺序进行处理-第一个匹配模板达到要求。可以使用PUT mapping API将新的模板附加到列表的尾部。如果新的模板与现有的模板同名，它将会替换旧的版本。
### `match_mapping_type（匹配映射类型）`
match\_mapping\_type通过动态字段映射检测数据类型的匹配，换句话说，就是Elasticsearch认为该字段应该具有的数据类型。只能自动检测以下数据类型：boolean(布尔类型),date(日期),double(浮点型),long(长整型),object(对象类型),string(字符类型)。同时，它也接受\*来匹配所有数据类型。
例如，如果我们要将所有整数字段映射为integer(整型)而不是long(长整型),并且所有string(字符串类型)字段都是text(文本)和keyword(关键词),我们可以使用以下模板：
```
PUT my_index
{
"mappings": {
"my_type": {
"dynamic_templates": [
{
"integers": {
"match_mapping_type": "long",
"mapping": {
"type": "integer"
}
}
},
{
"strings": {
"match_mapping_type": "string",
"mapping": {
"type": "text",
"fields": {
"raw": {
"type": "keyword",
"ignore_above": 256
}
}
}
}
}
]
}
}}
PUT my_index/my_type/1{
"my_integer": 5, #1
"my_string": "Some string" #2
}
```
| 1 | my\_integer字段被映射为integer(整数类型)。 |
| - | --------------------------------------------- |
| 2 | my\_string字段被映射为text(文本类型),并且是keword(关键字)多字段。 |
### `match` **and** `unmatch（匹配和不匹配）`
match(匹配)参数使用模式匹配字段名称，而unmatch(不匹配)使用模式排除match(匹配)的字段。
以下示例匹配名称为long\_开头(除了以\_text结尾的字段字符串除外)的所有string(字符串类型)字段，并将其映射为long(长整型)字段：
```
PUT my_index
{
"mappings": {
"my_type": {
"dynamic_templates": [
{
"longs_as_strings": {
"match_mapping_type": "string",
"match": "long_*",
"unmatch": "*_text",
"mapping": {
"type": "long"
}
}
}
]
}
}}
PUT my_index/my_type/1{
"long_num": "5", #1
"long_text": "foo" #2
}
```
| 1 | long\_num字段被映射为long(长整型)。 |
| - | --------------------------------- |
| 2 | long\_text字段使用默认的string(字符串类型)映射。 |
### `match_pattern（模式匹配）`
match\_pattern参数调整match参数的行为，使其在字段名称上支持匹配完整的Java正则表达式，而不是简单的通配符，例如：
```
"match_pattern": "regex",
"match": "^profit_\d+$"
```
### `path_match` **and** `path_unmatch(路径匹配和不匹配路径)`
path\_match和path\_unmatch参数的工作方式与match和unmathc相同，但是字段运行在完整的路径上，而不仅仅是最终的名称，例如：some\_object.\*.some\_field。
此示例将name对象中的任何字段的值复制到顶级full\_name字段，但middle字段除外：
```
PUT my_index
{
"mappings": {
"my_type": {
"dynamic_templates": [
{
"full_name": {
"path_match": "name.*",
"path_unmatch": "*.middle",
"mapping": {
"type": "text",
"copy_to": "full_name"
}
}
}
]
}
}
}
PUT my_index/my_type/1
{
"name": {
"first": "Alice",
"middle": "Mary",
"last": "White"
}
}
```
### `{name}` **and** `{dynamic_type}`
在映射中{name}和{dynamic\_type}占位符会被替换为字段名称和检测到的动态类型。以下示例将所有的字符串类型设置为使用与该字段名称相同的analyzer(分析器)，并禁用所有非字符串字段的doc\_values：
```
PUT my_index
{
"mappings": {
"my_type": {
"dynamic_templates": [
{
"named_analyzers": {
"match_mapping_type": "string",
"match": "*",
"mapping": {
"type": "text",
"analyzer": "{name}"
}
}
},
{
"no_doc_values": {
"match_mapping_type":"*",
"mapping": {
"type": "{dynamic_type}",
"doc_values": false
}
}
}
]
}
}
}
PUT my_index/my_type/1
{
"english": "Some English text", # 1
"count": 5 # 2
}
```
| 1 | english字段通过english分析器映射为string（字符串）字段。 |
| - | -------------------------------------- |
| 2 | count字段通过禁用的doc\_values映射为long（长整型）字段。 |
## **Template examples（模板示例）**
以下是一些可能有用的动态模板示例：
#### **Structured search（结构化搜索）**
默认情况下，elasticsearch将字符串字段映射为具有子keyword(关键字)字段的text(文本)字段。但是，如果你只想索引结构化内容，对全文检索不感兴趣，你可以使用elasticsearch将你的字段映射为“关键字”。请注意，这意味着为了搜索这些字段，你必须搜索与索引完全相同的值。
```
PUT my_index
{
"mappings": {
"my_type": {
"dynamic_templates": [
{
"strings_as_keywords": {
"match_mapping_type": "string",
"mapping": {
"type": "keyword"
}
}
}
]
}
}
}
```
#### `text`**-only mappings for strings（字符串的纯文字映射）**
与上一个例子相反，如果你唯一关心的字符串字段是全文检索，并且如果你不打算在该字符串字段上运行聚合，排序或精确搜索，你可以告诉elasticsearch将它仅映射为文本字段(这是5.0之前的默认行为)：
```
PUT my_index
{
"mappings": {
"my_type": {
"dynamic_templates": [
{
"strings_as_text": {
"match_mapping_type": "string",
"mapping": {
"type": "text"
}
}
}
]
}
}}
```
#### **Disabled norms（禁用规范）**
Norms(规范)是索引时评分的因子。如果你不关心评分，不按分数排序文档，则可能会出现这种情况，你可以在索引中禁用这些评分因子的存储，这样能够节省一些空间。
```
PUT my_index
{
"mappings": {
"my_type": {
"dynamic_templates": [
{
"strings_as_keywords": {
"match_mapping_type": "string",
"mapping": {
"type": "text",
"norms": false,
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
}
}
}
]
}
}
}
```
子keyword字段出现在此模板中，用以同动态映射的默认规则保持一致。当然，如果你不需要它们，你可以按上一节所述删除它，因为你不需要在此字段上执行精确搜索或聚合。
#### **Time-series（时间序列）**
当使用elasticsearch进行时间序列分析，通常你会经常聚合许多数字字段，但不会过滤。在这种情况下，你可以禁用这些字段上的索引来节省磁盘空间，同时可能获得一些索引速度的提升：
```
PUT my_index
{
"mappings": {
"my_type": {
"dynamic_templates": [
{
"unindexed_longs": {
"match_mapping_type": "long",
"mapping": {
"type": "long",
"index": false
}
}
},
{
"unindexed_doubles": {
"match_mapping_type": "double",
"mapping": {
"type": "float", # 1
"index": false
}
}
}
]
}
}
}
```
| 1 | 像默认的动态映射规则一样，doubles(双精度)映射为floats(浮点),通常情况下是足够准确的，但只需要一半的磁盘空间。 |
| - | --------------------------------------------------------------- |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://xiaoxiami.gitbook.io/elasticsearch/ji-chu/mapping/324dynamic-mappingff08-dong-tai-ying-she-ff09/dynamic-templatesdong-tai-mo-677f29.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.