Elasticsearch 映射Mappings (三)

文章目录

• 前言
• 一、Mapping简介
• • 查看索引映射
• [二、自动映射 dynamic mapping](#二、自动映射 dynamic mapping)
• • 自动类型推断
  • mapping注意点
• [三、手动映射 Expllicit mapping](#三、手动映射 Expllicit mapping)
• • 创建索引
• [四、自动映射模板 Dynamic Templates](#四、自动映射模板 Dynamic Templates)
• • 定义映射模板
  • 规则判定：conditlons
  • • match_mapping_type
    • match、unmatch
    • path_match、path_unmatch
    • 分词器变量
• 总结

---

前言

本文主要记录映射Mappings的作用、类型、ES常用数据类型、常见参数、重要的数据类型、映射配置、映射模板。

静态参数使不可修改的，所以mappings里的配置需要谨慎行事

---

一、Mapping简介

mapping类似Mysql中的表结构，在Maping里包含了一些属性，比如字段名称、类型、字段使用的分词器、是否评分、是否创建索引等属性，并且在ES中一份字段可以有多个类型。

查看索引映射

所有(默认创建keyword映射)

GET <索引名>/_mapping

{
  "text_create": {
    "mappings": {
      "properties": {
        "name": {
          "type": "text",
          "fields": {
            "keyword": {
              "type": "keyword",
              "ignore_above": 256
            }
          }
        }
      }
    }
  }
}

查看指定

GET <索引名>/_mapping/field/<字段名称>

{
  "text_create": {
    "mappings": {
      "name": {
        "full_name": "name",
        "mapping": {
          "name": {
            "type": "text",
            "fields": {
              "keyword": {
                "type": "keyword",
                "ignore_above": 256
              }
            }
          }
        }
      }
    }
  }
}

---

二、自动映射 dynamic mapping

在索引文档写入时发生自动创建mapping的机制。在写入文档时会自动为该文档创建mapping映射字段。在创建索引时不要求创建mapping映射，ES会根据字段值来推断字段类型，进而创建并指定索引类型。

自动类型推断

自动类型推断的规则为：

field type	dynamic	runtime
true/false	boolean	boolean
小数	float	double
数字	long	long
object	object	-
数组	取决于数组中的第一个非空元素类型	取决于数组中的第一个非空元素类型
日期格式字符串	date	date
数字类型字符串	float/long	double/long
其它字符串	text + keyword	keyword

自动映射器会尽可能的把字段映射为宽字段类型

PUT text_create/_doc/1
{
  "price": 18.12,
  "display": true,
  "object":{
    "1":1,
    "2":2
  },
  "arey" :[
    "3","4"
    ],
    "time": "2011-11-12"
}

mapping对应映射

{
  "text_create": {
    "mappings": {
      "properties": {
        "age": {
          "type": "long"
        },
        "arey": {
          "type": "text",
          "fields": {
            "keyword": {
              "type": "keyword",
              "ignore_above": 256
            }
          }
        },
        "display": {
          "type": "boolean"
        },
        "name": {
          "type": "text",
          "fields": {
            "keyword": {
              "type": "keyword",
              "ignore_above": 256
            }
          }
        },
        "object": {
          "properties": {
            "1": {
              "type": "long"
            },
            "2": {
              "type": "long"
            }
          }
        },
        "price": {
          "type": "float"
        },
        "time": {
          "type": "text",
          "fields": {
            "keyword": {
              "type": "keyword",
              "ignore_above": 256
            }
          }
        }
      }
    }
  }
}

mapping注意点

• ES 没有隐式转换
• ES 不支持类型修改
• 生产环境尽可能避免使用 dynamic mapping

---

三、手动映射 Expllicit mapping

也称为显示映射，在索引文档写入前。创建索引并且指定索引中每个字段类型、分词器等参数。

mapping索引创建完成后，部分mapping的属性时不允许更改的

创建索引

PUT text_mapping
{
  "mappings": {
    "properties": {
      "text_field" : {
        "type": "text",
        "fields": {
          "text_filed_keyword":{
          "type": "keyword"
        }
          
        }
      },
      "long_field": {
        "type": "long"
      }
    }
  }
}

---

四、自动映射模板 Dynamic Templates

在定义字段映射的时候，往往字段不一定有具体的名称，有时候希望对一类相同或者相似特征的字段定义相同的映射，此时可以使用Dynamic Templates。

定义映射模板

"dynamic_templates": [
  {
    "my_template_name": {
      ... match conditions ...
      "mapping":{...}
    }
  },
  ...
]

规则判定：conditlons

match_mapping_type

用于匹配数据类型

例子

PUT templates_text
{
  "mappings": {
    "dynamic_templates": [
      {
        "integers":{
          "match_mapping_type": "long",
          "mapping": {
            "type": "integer"
          }
        }
      },
      {
        "integers":{
          "match_mapping_type":"string",
          "mapping": {
            "type": "keyword"
          }
        }
      }
      ]
  }
}

插入数据,对应的字段将会自动带上对应的类型。

PUT templates_text/_doc/1
{
  "my_integer": 500,
  "my_string": "smz"
}

      "properties": {
        "my_integer": {
          "type": "integer"
        },
        "my_string": {
          "type": "keyword"
        }
      }

---

match、unmatch

用以匹配字段名称规则，支持通配符、正则表达式。

正则：

 "match_pattern": "regex",
 "match": "^profit_\d+$"

示例：

PUT templates_text2
{
  "mappings": {
    "dynamic_templates": [
      {
        "longs_as_strings":{
          "match_mapping_type": "string",
          "match": "num_*", #以num_*开头
          "unmatch": "*_text",#不以_text结尾
          "mapping": {
            "type": "long"
          }
        }
      }
      ]
  }
}

---

path_match、path_unmatch

用于嵌套字段

用例：

PUT templates_text3
{
  "mappings": {
    "dynamic_templates": [
      {
        "full_name":{
          "path_match": "name.*", #路径
          "path_unmatch": "*.middle",#路径不匹配
          "mapping": {
            "type": "text",
            "copy_to": "full_name"#符合的字段拷贝到此
          }
        }
      }
      ]
  }
}

---

分词器变量

PUT templates_text4
{
  "mappings": {
    "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"
          }
        }
      }
      ]
  }
}

以上示例，定义的两个模板，有以下规则：

• 所有字符串类型的字段，其分词器都会定义为和字段名称一致的分词器
• 所有非文本类型的字段，都会关闭doc_values

---

总结

本文主要记录了ES映射以及映射配置、映射模板。