ES dynamic mapping（动态映射）

我会带着你远行 2022-12-11 11:29 211阅读 0赞

今天有小伙伴问，Elasticsearch 索引里面的mapping 设置 dynamic = true是什么意思？

### **一：ES mapping  dynamic是做什么用的** ###

*  Mapping中的字段类型一旦设定后，禁止直接修改，原因是：Lucene实现的倒排索引生成后不允许修改
 *  只能新建一个索引，然后reindex数据
 *  默认允许新增字段
 *  通过dynamic参数来控制字段的新增：
    
     *  true（默认）允许自动新增字段，但是mapping不显示，查询返回JSON有
     *  false 不允许自动新增字段，但是文档可以正常写入，但无法对新增字段进行查询等操作
     *  strict 文档不能写入，报错

### **约束策略 ** ###

<table> 
 <thead> 
  <tr> 
   <th>策略</th> 
   <th>功能说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>true</code></td> 
   <td>开启 —— 遇到陌生字段时, 进行动态映射</td> 
  </tr> 
  <tr> 
   <td><code>false</code></td> 
   <td>关闭 —— 忽略遇到的陌生字段</td> 
  </tr> 
  <tr> 
   <td><code>strict</code></td> 
   <td>遇到陌生字段时, 作报错处理</td> 
  </tr> 
 </tbody> 
</table>

### **二：实例演示 ** ###

**1：约束策略 true**

PUT my_index
    
    {
      "mappings": {
        "_doc": {
          "dynamic": true,         //开启 —— 遇到陌生字段时, 进行动态映射
          "properties": {
            "user": { 
              "properties": {
                "name": {
                  "type": "text"
                }
              }
            }
          }
        }
      }
    }

put my_index/_doc/1
    {
      "name": "John Smith",
      "first_name": "John",
      "last_name": "Smith"
    }

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lleGlhb21vZGVtbw_size_16_color_FFFFFF_t_70][]

![20200930143526156.png][]

![20200930144724648.png][]

**2：约束策略 false**

delete my_index
    {}
    
    PUT my_index
    
    {
      "mappings": {
        "_doc": {
          "dynamic": false, 			// 关闭 —— 忽略遇到的陌生字段
          "properties": {
            "user": { 
              "properties": {
                "name": {
                  "type": "text"
                }
              }
            }
          }
        }
      }
    }

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lleGlhb21vZGVtbw_size_16_color_FFFFFF_t_70 1][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lleGlhb21vZGVtbw_size_16_color_FFFFFF_t_70 2][]

**3：约束策略 strict**

delete my_index
    {}
    
    PUT my_index
    
    {
      "mappings": {
        "_doc": {
          "dynamic": "strict",			// 严格控制策略
          "properties": {
            "user": { 
              "properties": {
                "name": {
                  "type": "text"
                }
              }
            }
          }
        }
      }
    }

put my_index/_doc/1
    {
      "name": "John Smith",
      "first_name": "John",
      "last_name": "Smith"
    }

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lleGlhb21vZGVtbw_size_16_color_FFFFFF_t_70 3][]

小伙伴你清楚了吗？

**以上案例均使用：Elasticsearch 6.5.3 版本演示。**

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lleGlhb21vZGVtbw_size_16_color_FFFFFF_t_70]: /images/20221123/ef934c1ceaa74ff698a46f155aafe7d4.png
[20200930143526156.png]: /images/20221123/cc4a0894476c4248a1cfbba66fa28112.png
[20200930144724648.png]: /images/20221123/6f513c2428154f9e800650e6e3d8408a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lleGlhb21vZGVtbw_size_16_color_FFFFFF_t_70 1]: /images/20221123/ce42f45ef5aa41748e71dfdd31c9142e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lleGlhb21vZGVtbw_size_16_color_FFFFFF_t_70 2]: /images/20221123/5c402f42344d4b0da96dd599ad88de5d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lleGlhb21vZGVtbw_size_16_color_FFFFFF_t_70 3]: /images/20221123/87b76544fc9c44f6844c28e3c37d4590.png