![469ba75fa2e891cec0a7dd914ffb64d7.gif](https://i-blog.csdnimg.cn/blog_migrate/a7ca0e324a9dd0fa79e468a915c391f5.gif)
点击上方“武培轩”,选择“设为星标”
技术文章第一时间送达!
本文主要是介绍 ElasticSearch 的文档增删改查和批量操作,同时会介绍一些 REST API 返回状态码的具体含义。
我们先来看下这个表:
![fe296be3b541809637f74dccc3d8fadf.png](https://i-blog.csdnimg.cn/blog_migrate/09bdb70ee4f2fe6cceebf41f5e9dea6f.jpeg)
这个表包含了 Index、Create、Read、Update、Delete 这五种方法,我们先来看下 CRUD 操作的 HTTP 请求都长什么样子?
首先是提供一个 HTTP 的 method,后面是索引名字,在 7.0 之后所以的 Type 都用 _doc
表示,后面是文档 id。
再简单了解了 CURD 操作的 HTTP 请求后,那么让我们先来了解下如何创建文档:
创建文档
![99a48e47c6c6c7ce9c692ece737c8989.png](https://i-blog.csdnimg.cn/blog_migrate/11f89aa07b4a3c9586c8afb274596f72.png)
Create 支持两种方式,一种是指定文档 id 创建文档,像上面这张图就是;另一种是通过调用 post /users/_doc
去让 ES 自动生成文档 id。
自己指定文档 id创建文档,需要考虑 id 的均衡性,避免产生分配不均衡的问题。ES 的 hash 函数会确保文档 id 被均匀分配到不同的分片。
当我们执行刚才的命令,可以返回如下结果:
![a86a63195cd6570fb9894882c195fd15.png](https://i-blog.csdnimg.cn/blog_migrate/176e951da8130b6954467c018117516d.png)
其中 _version
每一次操作,都会 + 1,它是一个锁的机制,当并行修改文档的时候,更新的版本号比文档当前的版本号小时就会报错,不允许做修改。
创建文档时,如果索引不存在,ES 会自动创建对应的 index 和 type。
接下来看下另一种创建文档的方式,不指定 id 创建文档,HTTP 请求也变为了 POST,具体的请求如下:
![f7633fdad8e13c0f5b4c1805079a4d72.png](https://i-blog.csdnimg.cn/blog_migrate/afb1de15b8038817d2ca21300aad4674.png)
返回的结果如下:
![d539fe5562cec2314f19d3563da97490.png](https://i-blog.csdnimg.cn/blog_migrate/fe538d8b9c16faf1769e49c57affc694.png)
Index 和 Create 区别为:如果文档不存在,就索引新的文档,否则现有文档就会被删除,新的文档被索引,版本信息 _version
+ 1。
查询文档
Get 方法比较简单,只需要 Get 索引名称/_doc/文档 id
,通过执行这个命令就可以知道文档的具体信息了。
![900818ede54d4e58316cbd4aec8ddad5.png](https://i-blog.csdnimg.cn/blog_migrate/af5735ae464cf398942ca10bab3ae960.png)
当执行这条语句后会返回 HTTP 200,具体返回结果如下:
![4a55f18f3023dc833d8a0337dc488c68.png](https://i-blog.csdnimg.cn/blog_migrate/f26a53d968393a57e0dc0d0586110d3f.png)
其中 _index
为索引,_type
为类型,_id
为文档 id,_version
为版本信息,_source
存储了文档的完整原始数据。
当查询的文档 id 不存在的时候,会返回 HTTP 404,且 found
为 false
,具体结果如下:
![2e2e72be0dcb3f8d865d6f6034ffb2a6.png](https://i-blog.csdnimg.cn/blog_migrate/ac95a7be2ab09cda5e0e6880069812f4.png)
更新文档
Update 方法采用 HTTP POST,在请求体中必须指明 doc,在把具体文档提供在 HTTP 的 body 里。Update 和 Index 方法不同,Update 方法不会删除原来的文档,而是实现真正的数据更新。
比如在原来的文档 id 为 1 的文档上增加字段,具体请求如下:
![b3d43fefe976b204d690224cfc411c94.png](https://i-blog.csdnimg.cn/blog_migrate/f9486df32ee3e3df6f8b1390b262cd6e.png)
执行后,版本信息 _version
+ 1,让我们再去查询下该文档:
![431c7c1e30c9feed5b154f6a6ebac1db.png](https://i-blog.csdnimg.cn/blog_migrate/81c8974e5b7bf54ed8bfbcdd13743c63.png)
可以看到,新增字段已经成功了。
删除文档
Delete 方法也很简单,Delete 索引名称/_doc/文档 id
就可以了,在这里就不再做代码演示了。
在介绍完文档的基本 CRUD 操作后,让我们来看看批量操作吧:
Bulk API
在一个 REST 请求中,重新建立网络开销是十分损耗性能的,因此 ES 提供 Bulk API,支持在一次 API 调用中,对不同的索引进行操作,从而减少网络传输开销,提升写入速率。
它支持 Index
、Create
、Update
、Delete
四种类型操作,可以在 URI 中指定索引,也可以在请求的方法体中进行。
同时多条操作中如果其中有一条失败,也不会影响其他的操作,并且返回的结果包括每一条操作执行的结果。
比如输入如下代码:
![0c3099cd1616073c9b468b94b1c31aa6.png](https://i-blog.csdnimg.cn/blog_migrate/8d430db4443e1fccb87de051eda3420a.png)
当我们执行命令后,结果如下:
![039241cef967a613587b1218bcc9f08f.png](https://i-blog.csdnimg.cn/blog_migrate/ae60398f4ad7f01dea2c03c897df8f73.png)
took
表示消耗了 93 毫秒,errors
为 true
表示在这些操作中错误发生,发现是 update 操作发生了错误,id 为 2 的文档不存在,所以报错了。
在使用 Bulk API 的时候,当 errors
为 true
时,需要把错误的操作修改掉,防止存到 ES 的数据有缺失。
批量查询文档
批量查询需要指明要查询文档的 id,可以在一个 _mget
操作里查询不同索引的数据,可以减少网络连接所产生的开销,提高性能。
下面我们来实际操作下,输入以下代码执行,就可以得到文档 id 为 1,3 的数据。
![cfa1f7f38a6ac0734b638c776be2e7ea.png](https://i-blog.csdnimg.cn/blog_migrate/79432a967a4a116b522b91c6da4d6c0f.png)
运行结果如下:
![acd4920702d5fd3a881ef4990029f7ab.png](https://i-blog.csdnimg.cn/blog_migrate/0cf08c59f816c269bbe593e4f3a5cff7.png)
在介绍完文档的一些操作,最后让我们看下 REST API 常见错误返回有哪些吧!
REST API 常见错误返回
刚才在演示中,当查询文档 id 不存在的时候就会报 404 错误,而且 ES 还有各种各样的返回,下面通过一个表格了解下:
![7a2871d7c944d57f181c7908ad6ccd66.png](https://i-blog.csdnimg.cn/blog_migrate/54a4f7955c64dfdcc6be934907c6f41e.png)
总结
本文主要介绍了文档的 CRUD 操作,还有 Bulk API、_mget API,这些批量操作可以提高 API 调用性能,但是不要一次发送过多数据,也有可能会对 ES 集群产生过大的压力,导致性能有所下降。一般建议是 1000-5000 个文档,如果你的文档很大,可以适当减少队列,大小建议是 5-15 MB,默认不能超过 100 M。
参考文献
Elastic Stack从入门到实践
Elasticsearch顶尖高手系列
Elasticsearch核心技术与实战
https://www.elastic.co/guide/en/elasticsearch/reference/7.1/docs-index_.html
完
![d99dcbe2b11612a293db39329a3094f3.gif](https://i-blog.csdnimg.cn/blog_migrate/e464c03e510f6854a93e4c59343f7f4d.gif)