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存在则会报错