ElasticSearch学习（二）： Mapping的数据类型和参数

秒速五厘米 2023-09-27 10:01 13阅读 0赞

### 1、什么是Mapping ###

Mapping 类似于数据库中的表结构定义schema，它的主要作用是：**用来定义索引中的字段的名称、定义字段的数据类型、定义字段类型的一些其它参数**，比如字符串、数字、布尔字段，倒排索引的相关配置，设置某个字段为不被索引、记录 position 等。每一种数据类型都有对应的使用场景，并且每个文档都有映射，但是在大多数使用场景中，我们并不需要显示的创建映射，因为ES中实现了动态映射。我们在索引中写入一个下面的JSON文档：

{
        "name":"jack",
        "age":18,
        "birthDate": "1991-10-05"
    }

在动态映射的作用下，name会映射成text类型，age会映射成long类型，birthDate会被映射为date类型，映射的索引信息如下。

{
      "mappings": {
        "_doc": {
          "properties": {
            "age": {
              "type": "long"
            },
            "birthDate": {
              "type": "date"
            },
            "name": {
              "type": "text",
              "fields": {
                "keyword": {
                  "type": "keyword",
                  "ignore_above": 256
                }
              }
            }
          }
        }
      }
    }

## 2、Mapping的数据类型 ##

ES 字段类型类似于 MySQL 中的字段类型，ES 字段类型主要有：**核心类型、复杂类型、地理类型、特殊类型，**常见的ELasticSearch数据类型如下：

<table> 
 <thead> 
  <tr> 
   <th>一级分类</th> 
   <th>二级分类</th> 
   <th>具体类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>核心类型</strong></td> 
   <td>字符串类型</td> 
   <td>string，text，keyword</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>整数类型</td> 
   <td>integer，long，short，byte</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>浮点类型</td> 
   <td>double，float，half_float，scaled_float</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>逻辑类型</td> 
   <td>boolean</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>日期类型</td> 
   <td>date</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>范围类型</td> 
   <td>range(Integer_range，long_range，date_range...)</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>二进制类型</td> 
   <td>binary (BASE64 的二进制)</td> 
  </tr> 
  <tr> 
   <td><strong>复合类型</strong></td> 
   <td>数组类型</td> 
   <td>array</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>对象类型</td> 
   <td>object</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>嵌套类型</td> 
   <td>nested</td> 
  </tr> 
  <tr> 
   <td><strong>地理类型</strong></td> 
   <td>地理坐标类型</td> 
   <td>geo_point</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>地理地图</td> 
   <td>geo_shape</td> 
  </tr> 
  <tr> 
   <td><strong>特殊类型</strong></td> 
   <td>IP类型</td> 
   <td>ip</td> 
  </tr> 
  <tr> 
   <td>...</td> 
   <td>...</td> 
   <td>...</td> 
  </tr> 
 </tbody> 
</table>

下面简单介绍一下常用的类型

### 2.1、字符串类型 ###

从ElasticSearch 5.x开始不再支持string，由text和keyword类型替代：

**【text 类型】：**

适用于需要被全文检索的字段，因为它会分词，例如新闻正文、邮件内容等比较长的文字，text 类型会被 Lucene 分词器（Analyzer）处理为一个个词项，并使用 Lucene 倒排索引存储，**text 字段不能被用于排序**。如果需要使用该类型的字段只需要在定义映射时指定 JSON 中对应字段的 type 为 text。

**【keyword】**：

只能通过精确值搜索到，适合简短、结构化字符串，例如主机名、姓名、商品名称等，**可以用于过滤、排序、聚合检索，也可以用于精确查询**。

> **总结：**
> 
> 对text类型的字段，会先使用分词器分词，生成倒排索引，用于之后的搜索。
> 
> 对keyword类型的字段，不会分词，搜索时只能精确查找。

#### **2.1.1、关于text类型的常用参数：** ####

1.  **analyzer：指明该字段用于索引时和搜索时的分析字符串的分词器**（使用search\_analyzer可覆盖它）。 默认为索引分析器或标准分词器
2.  **fielddata**：指明该字段是否可以使用内存中的fielddata进行排序，聚合或脚本编写？默认值为false，可取值true或false。（**排序，分组**需要指定为true）
3.  **fields**：【多数类型】text类型字段会被分词搜索，不能用于排序，而当字段既要能通过分词搜索，又要能够排序，就要**设置fields为keyword类型**进行聚合排序。
4.  index：【是否被索引】设置该字段是否可以用于搜索。默认为true，表示可以用于搜索。
5.  **search\_analyzer**：设置在搜索时，用于分析该字段的分析器，默认是【analyzer】参数的值。
6.  **search\_quote\_analyzer**：设置在遇到短语搜索时，用于分析该字段的分析器，默认是【search\_analyzer】参数的值。
7.  **index\_options**：【索引选项】用于控制在索引过程中哪些信息会被写入到倒排索引中。
    
     *  docs：只索引文档号到倒排索引中，但是并不会存储；
     *  freqs：文档号和关键词的出现频率会被索引，词频用于给文档进行评分，重复词的评分会高于单个次评分；
     *  positions：文档号、词频和关键词 term 的相对位置会被索引，相对位置可用于编辑距离计算和短语查询(不分词那种)；
     *  offsets：文档号、词频、关键词 term 的相对位置和该词的起始字符串偏移量。

#### 2.1.2、**关于keyword类型的常用参数：** ####

1.  **eager\_global\_ordinals**：指明该字段是否加载全局序数？默认为false，不加载。 对于经常用于术语聚合的字段，启用此功能是个好主意。
2.  **fields**：指明能以不同的方式索引该字段相同的字符串值，例如用于搜索的一个字段和用于排序和聚合的多字段。
3.  **index**：指明该字段是否可以被搜索，默认为true，表示可以被搜索
4.  **index\_options**：指定该字段应将哪些信息存储在索引中，以便用于评分。默认为docs，但也可以设置为freqs，这样可以在计算分数时考虑术语频率
5.  **norms**：在进行查询评分时，是否需要考虑字段长度，默认为false，不考虑
6.  **ignore\_above**：默认值是256，该参数的意思是，当字段文本的长度大于指定值时，不会被索引，但是会存储。即当字段文本的长度大于指定值时，聚合、全文搜索都查不到这条数据。ignore\_above 最大值是 32766 ，但是要根据场景来设置，比如说中文最大值 应该是设定在10922 。

### 2.2、数字类型 ###

ES支持的数字类型有：

整型数字类型：integer类型、long类型、short类型、byte类型。

浮点型数字类型： double类型、 float类型、 half\_float类型、 scaled\_float类型。

这类数据类型都是以确切值索引的，可以使用term查询精确匹配。数字类型的字段在满足需求的前提下应当尽量选择范围较小的数据类型，字段长度越短，搜索效率越高，对于浮点数，可以优先考虑使用 scaled\_float 类型，该类型可以通过缩放因子来精确浮点数，例如 12.34 可以转换为 1234 来存储。

*  long带符号的64位整数，最小值-2^63，最大值2^63-1
 *  integer带符号的32位整数，最小值-2^31，最大值2^31-1
 *  short带符号的16位整数，最小值-32768，最大值32767
 *  byte带符号的8位整数，最小值-128，最小值127
 *  double双精度64位IEEE 754 浮点数
 *  float单精度32位IEEE 754 浮点数
 *  half\_float半精度16位IEEE 754 浮点数
 *  scaled\_float带有缩放因子的缩放类型浮点数，依靠一个long数字类型通过一个固定的(double类型)缩放因数进行缩放。

整数类型：byte(8位 1字节), short(16位 2字节), int(32位 4字节), long(4位 8字节)  
浮点数：float（32位 4字节），double（64位 8字节）

注意：1个字节等于4bit，1bit等2位)

### 2.3、日期类型 ###

在 ES 中日期可以为以下形式：格式化的日期字符串，例如 2020-03-17 00:00、2020/03/17时间戳（和 1970-01-01 00:00:00 UTC 的差值），单位毫秒或者秒即使是格式化的日期字符串，**ES 底层依然采用的是时间戳的形式存储。**

日期类型一般会结合一个mapping参数来使用：

format ：自定义的日期格式，默认：strict\_date\_optional\_time || epoch\_millis。

-- 创建索引并设置结构
    
    -- 7.X写法
    PUT test_index
    {
      "mappings": {
        "properties": {
          "date1": {
            "type": "date"
          },
          "date2": {
            "type": "date",
            "format": "yyyy-MM-dd HH:mm:ss"
          },
          "date3": {
            "type": "date",
            "format": "yyyy-MM-dd HH:mm:ss||yyyy/MM/dd||epoch_millis"
          }
        }
      }
    }
    
    说明：es7.x前的版本需要在 properties 外添加 "_doc": {}
    
    
    #添加2条数据
    POST test_index/_doc
    {
      "dateTimeFormat": "2015-01-01 12:10:30"
    }
    
    
    PUT test_index/_doc/1
    {
      "date1": 1577808000000,
      "date2": "2020-01-01 00:00:00",
      "date3": "2020/01/01"
    }
    PUT test_index/_doc/2
    {
      "date1": 1577808000001,
      "date2": "2020-01-01 00:00:01",
      "date3": "2020/01/01"
    }
    #查询测试
    GET test_index/_search
    {
      "sort": [
        {
          "date2": {
            "order": "desc"
          }
        }
      ]
    }

### 2.4、布尔类型 ###

JSON 文档中同样存在布尔类型，不过 JSON 字符串类型也可以被 ES 转换为布尔类型存储，前提是字符串的取值为 true 或者 false，布尔类型常用于检索中的过滤条件。

### 2.5、二进制类型 ###

二进制类型 **binary** 接受 BASE64 编码的字符串，默认 store 属性为 false，并且不可以被搜索。

### 2.6、范围类型 ###

范围类型可以用来表达一个数据的区间，所以会用到gt、gte、lt、lte…等逻辑表示符。可以分为6种：integer\_range、float\_range、long\_range、double\_range、date\_range以及ip\_range。

*  **integer\_range**，带符号的32位整数区间，最小值-231，最大值231-1
 *  **long\_range**，带符号的64位整数区间，最小值-263，最小值263-1
 *  **float\_range**，单精度32位IEEE 754浮点数区间
 *  **double\_range**，双精度64位IEEE 754浮点数区间
 *  **date\_range**，日期值范围，表示为系统纪元以来经过的无符号64位整数毫秒
 *  **ip\_range**，支持IPv4或IPv6（或混合）地址ip值范围

-- 7.X写法
    PUT test_index
    {
      "mappings": {
        "properties": {
          "data1": {
            "type": "integer_range"
          },
          "data2": {
            "type": "float_range"
          },
          "data3": {
            "type": "date_range",
            "format": "yyyy-MM-dd HH:mm:ss"
          },
          "data4": {
            "type": "ip_range"
          }
        }
      }
    }
    说明：es7.x前的版本需要在 properties 外添加 "_doc": {}
    
    
    PUT test_index/_doc/1
    {
      "date1": {
        "gte": 100,
        "lte": 200
      },
      "date2": {
        "gte": 21.21,
        "lte": 22
      },
      "date3": {
        "gte": "2020-01-01 00:00:00",
        "lte": "2020-01-02 00:00:00"
      },
      "date4": {
        "gte": "192.168.192.10",
        "lte": "192.168.192.11"
      }
    }

### 2.7、对象类型 ###

对象类型即一个JSON对象，JSON 字符串允许嵌套对象，所以一个文档可以嵌套多个、多层对象。可以通过对象类型来存储二级文档，不过由于 Lucene 并没有内部对象的概念，所以ES 会将原 JSON 文档扁平化，例如有下面这样的文档：

PUT test_index
    {
      "mappings": {
        "properties": {
          "user": {
            "type": "object"
          }
        }
      }
    }
    
    PUT test_index/_doc/1
    {
      "username": {
        "first": "zhang",
        "last": "san"
      }
    }

上面我们看到都是一个个分开的字段，而实际上 ES 会将其转换为以下格式，并通过 Lucene 存储，即使 name 是 object 类型：

{
        "username.first": "zhang",
        "username.last": "san"
    }

所以我们在进行条件搜索时也必须使用这种方式：

GET test_index/_search
    {
      "query": {
        "bool": {
          "must": [
            {
              "match": {
                "username.first": "zhang"
              }
            }
          ]
        }
      }
    }

**bool查询的使用**

*  `must` 查询必须匹配某些条件才可以返回
 *  `must_not`查询必须不匹配某些条件
 *  `should`当查询满足此条件时,会增加其`_score`值
 *  `filter` 必须匹配,但是结果不会计算分值。

### 2.8、嵌套类型 ###

嵌套类型可以看成是一个特殊的对象类型，在文档属性是一个对象数组时使用，它允许对象数组彼此独立地编制索引和查询，例如文档：

{
      "address": [
        {
          "country": "CN",
          "city": "BJ"
        },
        {
          "country": "US",
          "city": "NY"
        }
      ]
    }

示例中的文档在实际存储时，会被拆解为两个数组字段:

{
        "adress.country" : ["CN,"US"],
        "address.city" : ["BJ","NY"]
    }

这样一来，单个对象内部，country字段和city字段之间的匹配关系就丢失了。换句话说，使用CN与NY作为共同条件检索的文档时，上述文档也会被检索出来，这在逻辑上就出现了错误;

在示例中使用了bool组合查询，要求country字段为CN而city字段为NY。这样的文档显然并不存在，但由于数组中的对象被平铺为两个独立的数组字段，文档仍然会被检索出来。

为了解决对象类型在数组中丢失内部字段之间匹配关系的问题，Elasticsearch提供了一种特殊的对象类型nested。这种类型会为数组中的每一个对象创建一个单独的文档， 以保存对象的字段信息并使它们可检索。由于这类文档并不直接可见，而是藏置在父文档之中，所以这类文档可以称为为**隐式文档 或 嵌入文档**。

测试**nested查询**：

nested查询只能针对nested类型字段，需要通过path参数指定nested类型字段的路径，而在query参数中则包含了针对隐式文档的具体查询条件。

-- 删除索引
    DELETE test_index
    
    -- 创建索引
    PUT test_index
    {
      "mappings": {
        "properties": {
          "address": {
            "type": "nested"
          }
        }
      }
    }
    
    -- 索引添加文档，id设置为1
    PUT test_index/_doc/1
    {
      "address": [
        {
          "country": "CN",
          "city": "BJ"
        },
        {
          "country": "US",
          "city": "NY"
        }
      ]
    }
    
    
    #查询测试
    GET test_index/_search
    {
      "query": {
        "nested": {
          "path": "address",
          "query": {
            "bool": {
              "must": [
                {
                  "match": {
                    "address.country": "CN"
                  }
                },
                {
                  "match": {
                    "address.city": "NY"
                  }
                }
              ]
            }
          }
        }
      }
    }

在示例中再次使用CN与NY共同作为查询条件，但由于使用nested类型后会将数组中的对象转换成隐式文档，所以在 nested查询中将不会有文档返回了。将条件更换为CN和BJ，则有文档返回。

## 3、Mapping的主要参数 ##

### 3.1、mapping组成 ###

一个mapping主要有两部分组成：**metadata**和**mapping**：

**metadata**元数据字段用于自定义如何处理文档关联的数据。例如：

*  \_index：用于定义document属于哪个index
 *  \_type：类型，7.x已经移除的概念,6.x默认为\_doc
 *  \_id：document的唯一id
 *  \_source：存放原始的document数据
 *  \_size：\_source字段中存放的数据的大小

**mapping**中包含字段的类型和参数。本文主要介绍的mapping参数就需要在field中去定义。例如：

*  type：设置字段对应的类型，常见的有text，keyword等
 *  analyzer：指定一个用来文本分析的索引或者搜索text字段的分析器, 应用于索引以及查询.

### 3.2、mapping参数 ###

主要参数如下：

*  **analyzer：**只能用于text字段，用于根据需求设置不通的分词器，默认是ES的标准分词
 *  **boost：**默认值为1。用于设置字段的权重，主要应用于查询时候的评分
 *  **coerce：**默认是true。主要用于清理脏数据来匹配字段对应的类型。例如字符串“5”会被强制转换为整数，浮点数5.0会被强制转换为整数
 *  **copy\_to**：能够把几个字段拼成一个字段。老字段和新组成的字段都可以查询
 *  **doc\_values：**默认值为true。Doc Values和倒排索引同时生成，本质上是一个序列化的 列式存储。列式存储适用于聚合、排序、脚本等操作，也很适合做压缩。如果字段不需要聚合、排序、脚本等操作可以关闭掉，能节省磁盘空间和提升索引速度。
 *  **dynamic：**默认值为true。默认如果插入的document字段中有mapping没有的，会自动插入成功，并自动设置新字段的类型；如果一个字段中插入一个包含多个字段的json对象也会插入成功。但是这个逻辑可以做限制：
    
     *  ture: 默认值，可以动态插入.
     *  false：数据可写入但是不能被索引分析和查询，但是会保存到\_source字段。
     *  strict：无法写入
 *  **eager\_global\_ordinals：**默认值为false。设置每refresh一次就创建一个全局的顺序映射，用于预加载来加快查询的速度。需要消耗一定的heap。
 *  **enabled：**默认值为true。设置字段是否索引分析。如果设置为false，字段不对此字段索引分析和store，会导致此字段不能被查询和聚合，但是字段内容仍然会存储到\_source中。
 *  **fielddata：**默认值为false，只作用于text字段。默认text字段不能排序，聚合和脚本操作，可以通过开启此参数打开此功能。但是会消耗比较大的内存。
 *  **fields：**可以对一个字段设置多种索引类型，例如text类型用来做全文检索，再加一个keyword来用于做聚合和排序。
 *  **format：**用于date类型。设置时间的格式。
 *  **ignore\_above：**默认值为256，作用于keyword类型。指示该字段的最大索引长度（即超过该长度的内容将不会被索引分析），对于超过ignore\_above长度的字符串，analyzer不会进行索引分析，所以超过该长度的内容将不会被搜索到。注意：keyword类型的字段的最大长度限制为32766个UTF-8字符，text类型的字段对字符长度没有限制
 *  **ignore\_malformed：**默认为false。插入新document的时候，是否忽略字段的类型，默认字段类型必须和mapping中设置的一样
 *  **index\_options：**默认值为positions，只作用于text字段。控制将哪些信息添加到倒排索引中以进行搜索和突出显示。有4个选项：
    
     *  docs 添加文档号
     *  freqs 添加文档号和词频
     *  positions 添加文档号，词频，位置
     *  offsets 添加文档号，词频，位置，偏移量
 *  **index：**默认值为true。设置字段是否会被索引分析和可以查询
 *  **meta：**可以给字段设置metedata字段，用于标记等
 *  **normalizer：**可以对字段做一些标准化规则，例如字符全部大小写等
 *  **norms：**默认值为true。默认会存储了各种规范化因子，在查询的时候使用这些因子来计算文档相对于查询的得分，会占用一部分磁盘空间。如果字段不用于检索，只是过滤，查询等精确操作可以关闭。
 *  **null\_value：**null\_value意味着无法索引或搜索空值。当字段设置为 null , \[\] ,和 \[null\]（这些null的表示形式都是等价的），它被视为该字段没有值。通过设置此字段，可以设置控制可以被索引和搜索。
 *  **properties：**如果这个字段有嵌套属性，包含了多个子字段。需要用到properties
 *  **search\_analyzer：**默认值和analyzer相同。在查询时，先对要查询的text类型的输入做分词，再去倒排索引搜索，可以通过这个设置查询的分析器为其它的，默认情况下，查询将使用analyzer字段制定的分析器，但也可以被search\_analyzer覆盖
 *  **similarity：**用于设置document的评分模型，有三个：
    
     *  BM25:lucene的默认评分模型
     *  classic:TF/IDF评分模型
     *  boolean:布尔评分模型
 *  **store：**默认为false，lucene不存储原始内容，但是\_source仍然会存储。这个属性其实是lucene创建字段时候的一个选项，表明是否要单独存储原始值（\_source字段是elasticsearch单独加的和store没有关系）。如果字段比较长，从\_source中获取损耗比较大，可以关闭\_source存储，开启store。
 *  **term\_vector：** 用于存储术语的规则。默认值为no，不存储向量信息.