ES入门三部曲:索引操作，映射操作，文档操作

ES入门三部曲:索引操作，映射操作，文档操作

一、索引操作

1.创建索引库

#语法
PUT /索引名称
{
"settings": {
"属性名": "属性值"
}
}
#示例
PUT /es_index

说明：settings是索引库的设置，可以定义各种属性，一般可以不填写，直接走默认。

2.判断索引是否存在

#语法
HEAD  /索引名称

#示例
HEAD  /es_index

3.查看索引

# 语法
GET /索引名称

# 示例
GET  /es_index

# 批量查看索引
GET /索引名称1,索引名称2,索引名称3,...

# 查看所有索引
GET _all        ||        GET /_cat/indices?v

4.打开索引

# 语法
POST /索引名称/_open

# 示例
POST /es_index/_open

5.关闭索引

# 语法
POST /索引名称/_close

# 示例
POST /es_index/_close

6.删除索引库

# 语法
DELETE /索引名称1,索引名称2,索引名称3...

二、映射操作

索引创建后，等于有了关系型数据库中的database。Elasticsearch7.x取消了索引type类型的设置，不允许指定类型，默认为_doc，但字段仍然是有的，我们需要设置字段的约束信息，叫做字段映射（mapping）

字段的约束包括但不限于：

• 字段的数据类型
• 是否要存储
• 是否要索引
• 分词器

1.创建映射字段

语法

PUT /索引库名/_mapping
{
"properties": {
"字段名": {
"type": "类型",
"index": true，
"store": true，
"analyzer": "分词器"
}
}
}

字段名：任意填写，下面指定许多属性，例如：

• type：类型，可以是text、long、short、date、integer、object等
• index：是否索引，默认为true
• store：是否存储，默认为false
• analyzer：指定分词器

示例

PUT /es_index/_mapping/
{
"properties": {
"name": {
"type": "text",
"analyzer": "ik_max_word"
},
"job": {
"type": "text",
"analyzer": "ik_max_word"
},
"logo": {
"type": "keyword",
"index": "false"
},
"payment": {
"type": "float"
}
}
}

2.映射属性详解

1.type

我们说几个关键的：

• String类型，又分两种：

  • text：可分词，不可参与聚合
  • keyword：不可分词，数据会作为完整字段进行匹配，可以参与聚合

• Numerical：数值类型，分两类

  • 基本数据类型：long、interger、short、byte、double、float、half_float
  • 浮点数的高精度类型：scaled_float
    • 需要指定一个精度因子，比如10或100。elasticsearch会把真实值乘以这个因子后存储，取出时再还原。

• Date：日期类型

  elasticsearch可以对日期格式化为字符串存储，但是建议我们存储为毫秒值，存储为long，节省空间

• Array：数组类型

  • 进行匹配时，任意一个元素满足，都认为满足
  • 排序时，如果升序则用数组中的最小值来排序，如果降序则用数组中的最大值来排序

• Object：对象类型

  {name:"Amy",age:25,friend:{name: "DaMing", age:25}}
  

  如果存储到索引库的是对象类型，例如上面的friend，会把friend变成两个字段：friend.name和friend.age

2.index

index影响字段的索引情况。

• true：字段会被索引，则可以用来进行搜索。默认值就是true

• false：字段不会被索引，不能用来搜索

  index的默认值就是true，也就是说你不进行任何配置，所有字段都会被索引。
  
  但是有些字段是我们不希望被索引的，比如企业的logo图片地址，就需要手动设置index为false。

3.store

是否将数据进行独立存储。

原始的文本会存储在 source 里面，默认情况下其他提取出来的字段都不是独立存储的，是从

_source 里面提取出来的。当然你也可以独立的存储某个字段，只要设置store:true即可，获取独立存

储的字段要比从source中解析快得多，但是也会占用更多的空间，所以要根据实际业务需求来设置，

默认为false。

4.analyzer：指定分词器

一般我们处理中文会选择ik分词器 ik_max_word ik_smart

3.查看映射关系

• 查看单个索引的映射关系

  # 语法GET /索引名称/_mapping# 示例GET /es_index/_mapping
  

• 查看所有索引的映射关系

  # 语法GET _mapping   或者是   GET _all/_mapping
  

• 修改索引的映射关系

  # 语法PUT /索引库名/_mapping{"properties": {"字段名": {"type": "类型","index": true，"store": true，"analyzer": "分词器"}}}
  

  注意:修改映射增加字段 做其它更改只能删除索引 重新建立映射

4.一次性创建索引和映射

除了创建索引和映射分开做，也可以一次性的创建好索引以及映射

# 语法put /索引库名称{"settings":{"索引库属性名":"索引库属性值"},"mappings":{"properties":{"字段名":{"映射属性名":"映射属性值"}}}}# 示例PUT /es_index{"settings": {},"mappings": {"properties": {"name": {"type": "text","analyzer": "ik_max_word"}}}}

三、文档增删改以及局部更新

1.新增文档

• 新增文档(手动指定id)

  # 语法POST /索引名称/_doc/{id}# 示例POST /es_index/_doc/1{"name" : "zae","job" : "java开发","payment" : "1000","logo" :"http://www.lgstatic.com/thubnail_120x120/i/image/M00/21/3E/CgpFT1kVdzeAJNbUAABJB7x9sm8374.png"}
  

• 新增文档(自动生成id)

  # 语法POST /索引名称/_doc{"field":"value"}
  

  在创建文档完成后，，在响应结果中有个 id 字段，这个就是这条文档数据的 唯一标识 ，以后的
  
  增删改查都依赖这个id作为唯一标示，这里是Elasticsearch帮我们随机生成的id

2.查看单个文档

• 语法示例

  # 语法GET /索引名称/_doc/{id}# 示例GET/es_index/_doc/1
  

• 文档元数据解读

  • index ：document所属index
  • _type： document所属type，Elasticsearch7.x默认type为doc
  • id ：代表document的唯一标识，与index和type一起，可以唯一标识和定位一个document
  • _version：document的版本号，Elasticsearch利用version (版本号)的方式来确保应用中相互冲突的变更不会导致数据丢失。需要修改数据时，需要指定想要修改文档的version号，如果该版本不是当前版本号，请求将会失败
  • _seq_no：严格递增的顺序号，每个文档一个，Shard级别严格递增，保证后写入的Doc的seq_no大于先写入的Doc的seq_no
  • primary_term：任何类型的写操作，包括index、create、update和Delete，都会生成一个seq_no。
  • found ：true/false，是否查找到文档
  • _source 存储原始文档

3.查看所有文档

# 语法POST /索引名称/_search{"query":{"match_all": {}}}

4._source定制返回结果

某些业务场景下，我们不需要搜索引擎返回source中的所有字段，可以使用source进行定制，如下，多

个字段之间使用逗号分隔

# 示例GET /es_index/_doc/1?_source=name,job

5.更新文档（全部更新）

把新增的语法中请求方式改为PUT就是修改了，不过需要指定修改的id

# 语法PUT /索引名称/_doc/{id}

• 对应的id存在，则为修改
• 对应的id不存在，则为新增

6.更新文档（局部更新）

Elasticsearch可以使用PUT或者POST对文档进行更新(全部更新)，如果指定ID的文档已经存在，则执行

更新操作。

注意：Elasticsearch执行更新操作的时候，Elasticsearch首先将旧的文档标记为删除状态，然后添加新

的文档，旧的文档不会立即消失，但是你也无法访问，Elasticsearch会在你继续添加更多数据的时候在

后台清理已经标记为删除状态的文档。

全部更新，是直接把之前的老数据，标记为删除状态，然后，再添加一条更新的（使用PUT或者

POST）

局域更新，只是修改某个字段（使用POST）

# 语法POST /索引名/_update/{id}{"doc":{"field":"value"}}

7.删除文档

• 根据id进行删除操作

  # 语法DELETE /索引名/_doc/{id}
  

• 根据条件删除

  # 语法POST /索引库名/_delete_by_query{"query": {"match": {"字段名": "搜索关键字"}}}# 示例：将name字段为2的文档数据删除POST /es_index/_delete_by_query{"query":{"match":{"name":"2"}}}
  

• 删除所有文档

  POST 索引名/_delete_by_query{"query": {"match_all": {}}}
  

8.文档的全量替换、强制创建

• 全量替换

  • 语法与创建文档是一样的，如果文档id不存在，那么就是创建；如果文档id已经存在，那么就是全量替换操作，替换文档的json串内容；
  • 文档是不可变的，如果要修改文档的内容，第一种方式就是全量替换，直接对文档重新建立索引，替换里面所有的内容，elasticsearch会将老的文档标记为deleted，然后新增我们给定的一个文档，当我们创建越来越多的文档的时候，elasticsearch会在适当的时机在后台自动删除标记为deleted的文档

• 强制创建

  # 强制创建PUT /index/_doc/{id}?op_type=create {}，PUT /index/_doc/{id}/_create {}# 注意，强制创建时，如果id存在则会报错