elasticsearch mappings之dynamic的三种状态

Posted 2022-08-10 exman

目录

• 前言
• 动态映射（dynamic：true）
• 静态映射（dynamic：false）
• 严格模式（dynamic：strict）

• 返回主目录

前言

回到顶部

一般的，mapping则又可以分为动态映射（dynamic mapping）和静态（显示）映射（explicit mapping）和精确（严格）映射（strict mappings），具体由dynamic属性控制。

动态映射（dynamic：true）

回到顶部

现在有这样的一个索引：

PUT m1

  "mappings": 
    "doc":
      "properties": 
        "name": 
          "type": "text"
        ,
        "age": 
          "type": "long"
        
      
    
  

通过GET m1/_mapping看一下mappings信息：

  "m1" : 
    "mappings" : 
      "doc" : 
        "dynamic" : "true",
        "properties" : 
          "age" : 
            "type" : "long"
          ,
          "name" : 
            "type" : "text"
          
        
      
    
  

添加一些数据，并且新增一个sex字段：

PUT m1/doc/1

  "name": "小黑",
  "age": 18,
  "sex": "不详"

当然，新的字段查询也没问题：

GET m1/doc/_search

  "query": 
    "match": 
      "sex": "不详"
    
  

返回结果：

  "took" : 1,
  "timed_out" : false,
  "_shards" : 
    "total" : 5,
    "successful" : 5,
    "skipped" : 0,
    "failed" : 0
  ,
  "hits" : 
    "total" : 1,
    "max_score" : 0.5753642,
    "hits" : [
      
        "_index" : "m1",
        "_type" : "doc",
        "_id" : "1",
        "_score" : 0.5753642,
        "_source" : 
          "name" : "小黑",
          "age" : 18,
          "sex" : "不详"
        
      
    ]
  

现在，一切都很正常，跟elasticsearch自动创建时一样。那是因为，当 Elasticsearch 遇到文档中以前未遇到的字段，它用动态映射来确定字段的数据类型并自动把新的字段添加到类型映射。我们再来看mappings你就明白了：

  "m1" : 
    "mappings" : 
      "doc" : 
        "dynamic" : "true",
        "properties" : 
          "age" : 
            "type" : "long"
          ,
          "name" : 
            "type" : "text"
          ,
          "sex" : 
            "type" : "text",
            "fields" : 
              "keyword" : 
                "type" : "keyword",
                "ignore_above" : 256
              
            
          
        
      
    
  

通过上例可以发下，elasticsearch帮我们新增了一个sex的映射。所以。这一切看起来如此自然。这一切的功劳都要归功于dynamic属性。我们知道在关系型数据库中，字段创建后除非手动修改，则永远不会更改。但是，elasticsearch默认是允许添加新的字段的，也就是dynamic：true。
其实创建索引的时候，是这样的：

PUT m1

  "mappings": 
    "doc":
      "dynamic":true,
      "properties": 
        "name": 
          "type": "text"
        ,
        "age": 
          "type": "long"
        
      
    
  

上例中，当dynamic设置为true的时候，elasticsearch就会帮我们动态的添加映射属性。也就是等于啥都没做！
这里有一点需要注意的是：mappings一旦创建，则无法修改。因为Lucene生成倒排索引后就不能改了。

静态映射（dynamic：false）

回到顶部

现在，我们将dynamic值设置为false：

PUT m2

  "mappings": 
    "doc":
      "dynamic":false,
      "properties": 
        "name": 
          "type": "text"
        ,
        "age": 
          "type": "long"
        
      
    
  

现在再来测试一下false和true有什么区别：

PUT m2/doc/1

  "name": "小黑",
  "age":18

PUT m2/doc/2

  "name": "小白",
  "age": 16,
  "sex": "不详"

第二条数据相对于第一条数据来说，多了一个sex属性，我们以sex为条件来查询一下：

GET m2/doc/_search

  "query": 
    "match": 
      "sex": "不详"
    
  

结果如下：

  "took" : 0,
  "timed_out" : false,
  "_shards" : 
    "total" : 5,
    "successful" : 5,
    "skipped" : 0,
    "failed" : 0
  ,
  "hits" : 
    "total" : 0,
    "max_score" : null,
    "hits" : [ ]
  

结果是空的，也就是什么都没查询到，那是为什呢？来GET m2/_mapping一下此时m2的mappings信息：

` "m2" : "mappings" : "doc" : "dynamic" : "false", "properties" : "age" : "type" : "long" , "name" : "type" : "text"
可以看到elasticsearch并没有为新增的sex建立映射关系。所以查询不到。
当elasticsearch察觉到有新增字段时，因为dynamic:false的关系，会忽略该字段，但是仍会存储该字段。
在有些情况下，dynamic:false依然不够，所以还需要更严谨的策略来进一步做限制。

严格模式（dynamic：strict）

回到顶部

让我们再创建一个mappings，并且将dynamic的状态改为strict：

PUT m3

  "mappings": 
    "doc": 
      "dynamic": "strict", 
      "properties": 
        "name": 
          "type": "text"
        ,
        "age": 
          "type": "long"
        
      
    
  

现在，添加两篇文档：

PUT m3/doc/1

  "name": "小黑",
  "age": 18

PUT m3/doc/2

  "name": "小白",
  "age": 18,
  "sex": "不详"

第一篇文档添加和查询都没问题。但是，当添加第二篇文档的时候，你会发现报错了：

  "error": 
    "root_cause": [
      
        "type": "strict_dynamic_mapping_exception",
        "reason": "mapping set to strict, dynamic introduction of [sex] within [doc] is not allowed"
      
    ],
    "type": "strict_dynamic_mapping_exception",
    "reason": "mapping set to strict, dynamic introduction of [sex] within [doc] is not allowed"
  ,
  "status": 400

错误提示，严格动态映射异常！说人话就是，当dynamic:strict的时候，elasticsearch如果遇到新字段，会抛出异常。
上述这种严谨的作风洒家称为——严格模式！

小结：

• 动态映射（dynamic：true）：动态添加新的字段（或缺省）。
• 静态映射（dynamic：false）：忽略新的字段。在原有的映射基础上，当有新的字段时，不会主动的添加新的映射关系，只作为查询结果出现在查询中。
• 严格模式（dynamic： strict）：如果遇到新的字段，就抛出异常。

一般静态映射用的较多。就像html的img标签一样，src为自带的属性，你可以在需要的时候添加id或者class属性。
当然，如果你非常非常了解你的数据，并且未来很长一段时间不会改变，strict不失为一个好选择。