《ElasticSearch6.x实战教程》之简单的API
第三章-简单的api
万丈高楼平地起
es提供了多种操作数据的方式,其中较为常见的方式就是restful风格的api。
简单的体验
利用postman发起http请求(当然也可以在命令行中使用curl命令)。
索引index
创建索引
创建一个名叫demo
的索引:
put http://localhost:9200/demo
es响应:
{ "acknowledged": true, "shards_acknowledged": true, "index": "demo" }
在创建索引时,可指定主分片和分片副本的数量:
put http://localhost:9200/demo
{ "settings":{ "number_of_shards":1, "number_of_replicas":1 } }
es响应:
{ "acknowledged": true, "shards_acknowledged": true, "index": "demo" }
查看指定索引
get http://localhost:9200/demo
es响应:
{ "demo": { "aliases": {}, "mappings": {}, "settings": { "index": { "creation_date": "1561110747038", "number_of_shards": "1", "number_of_replicas": "1", "uuid": "kjpqdut6tmyywg1p7qgccw", "version": { "created": "5060499" }, "provided_name": "demo" } } } }
查询es中的索引
查询es中索引情况:
get http://localhost:9200/_cat/indices?v
es响应:
health | status | index | uuid | pri | rep | docs.count | docs.deleted | store.size | pri.store.size |
---|---|---|---|---|---|---|---|---|---|
yellow | open | demo | wqkto5cctpwndp3hgplfxa | 5 | 1 | 0 | 0 | 810b | 810b |
yellow | open | .kibana | pwkw9hjyrko7_pe0mne05g | 1 | 1 | 1 | 0 | 3.2kb | 3.2kb |
可以看到当前es中一共有2个索引,一个是我们刚创建的demo
,另一个是kibana创建的索引.kibana
。表格中有一些信息代表了索引的一些状态。
health:健康状态,red表示不是所有的主分片都可用,即部分主分片可用。yellow表示主分片可用备分片不可用,常常是单机es的健康状态,greens表示所有的主分片和备分片都可用。(官方对集群健康状态的说明,)
status:索引状态,open表示打开可对索引中的文档数据进行读写,close表示关闭此时索引占用的内存会被释放,但是此时索引不可进行读写操作。
index:索引
uuid:索引标识
pri:索引的主分片数量
rep:索引的分片副本数量,1表示有一个分片副本(有多少主分片就有多少备分片,此处表示5个备分片)。
docs.count:文档数量
docs.deleted:被删除的文档数量
store.size:索引大小
pri.store.size:主分片占用的大小
删除索引
删除demo
索引,删除索引等同于删库跑路,请谨慎操作。
delete http://localhost:9200/demo
es响应:
{ "acknowledged": true }
类型type(同时定义映射mapping字段及类型)
创建类型
在前面基本术语中我们提到类型type类似关系型数据库中的表,映射mapping定义表结构。创建类型type时需要配合映射mapping。
创建索引demo
的类型为example_type
,包含两个字段:created
类型为date,message
类型为keyword:
方式一:
put http://localhost:9200/demo/_mapping/example_type { "properties":{ "created":{ "type":"date" }, "message":{ "type":"keyword" } } }
此时再次执行查询索引的操作,已经可以发现类型type被创建了,遗憾的是,如果类型type(或者映射mapping)一旦定义,就不能删除,只能修改,为了保证本教程顺利进行方式二创建类型,所以此处执行delete http://localhost:9200/demo
删除索引。删除索引后不要再创建索引,下面的这种方式是在创建索引的同时创建type并定义mapping
方式二:
put http://localhost:9200/demo { "mappings":{ "example_type":{ "properties":{ "created":{ "type":"date" }, "message":{ "type":"keyword" } } } } }
此时执行get http://localhost:9200/demo
,可以看到我们在es中创建了第一个索引以及创建的表结构,接下来插入就是数据(即文档)。
文档document
插入文档
系统定义_id
post http://localhost:9200/demo/example_type { "created":1561135459000, "message":"test1" }
es响应:
{ "_index": "demo", "_type": "example_type", "_id": "awt67ql_tf0fgxupylbx", "_version": 1, "result": "created", "_shards": { "total": 2, "successful": 1, "failed": 0 }, "created": true }
查询文档
elasticsearch的核心功能——搜索。
post http://localhost:9200/demo/example_type/_search?pretty
es响应:
{ "took": 183, "timed_out": false, "_shards": { "total": 5, "successful": 5, "skipped": 0, "failed": 0 }, "hits": { "total": 1, "max_score": 1, "hits": [ { "_index": "demo", "_type": "example_type", "_id": "awt67ql_tf0fgxupylbx", "_score": 1, "_source": { "created": 1561135459000, "message": "test1" } } ] } }
关于文档的查询是elasticsearch的核心,后面的章节会详细介绍一些基本的简单查询和更为高级的复杂查询,此处仅作为对插入数据的验证,不做过多展开。
修改文档
根据文档_id
修改
post http://localhost:9200/demo/example_type/awt67ql_tf0fgxupylbx/_update { "doc":{ "message":"updated" } }
es响应:
{ "_index": "demo", "_type": "example_type", "_id": "awt67ql_tf0fgxupylbx", "_version": 2, "result": "updated", "_shards": { "total": 2, "successful": 1, "failed": 0 } }
删除文档
删除_id
为awt67ql_tf0fgxupylbx的文档
delete http://localhost:9200/demo/example_type/awt67ql_tf0fgxupylbx
es的响应:
{ "found": true, "_index": "demo", "_type": "example_type", "_id": "awt67ql_tf0fgxupylbx", "_version": 2, "result": "deleted", "_shards": { "total": 2, "successful": 1, "failed": 0 } }
关注公众号:coderbuff,回复“es”获取《elasticsearch6.x实战教程》完整版pdf,回复“抽奖”参与《从lucene到elasticsearch:全文检索实战》图书抽奖活动(7.17-7.21)。
推荐阅读
-
html5教程调用绘图api画简单的圆形代码分享
-
ElasticSearch实战系列三: ElasticSearch的JAVA API使用教程
-
html5教程调用绘图api画简单的圆形代码分享
-
《ElasticSearch6.x实战教程》之简单搜索、Java客户端(上)
-
Vue.js实战之Vuex的入门教程
-
使用Python下的XSLT API进行web开发的简单教程
-
使用ASP.NET Web Api构建基于REST风格的服务实战系列教程——使用Repository模式构建数据库访问层
-
asp.net core 系列之webapi集成Dapper的简单操作教程
-
asp.net core 系列之webapi集成EFCore的简单操作教程
-
简单安装mysql的方式之rpm包安装教程