这篇博客的命令分为ES集群相关命令
,索引CRUD命令
,文档CRUD命令
。这里不包括Query查询命令,它单独写一篇博客。
一、ES集群相关命令
ES集群相关命令主要是_cat
命令,所以这里详细讲解下该命令。
1、_cat命令
_cat
系列提供了一系列查询Elasticsearch集群状态的接口。
/_cat/allocation #查看单节点的shard分配整体情况
/_cat/shards #查看各shard的详细情况
/_cat/shards/{index} #查看指定分片的详细情况
/_cat/master #查看master节点信息
/_cat/nodes #查看所有节点信息
/_cat/indices #查看集群中所有index的详细信息
/_cat/indices/{index} #查看集群中指定index的详细信息
/_cat/segments #查看各index的segment详细信息,包括segment名, 所属shard, 内存(磁盘)占用大小, 是否刷盘
/_cat/segments/{index}#查看指定index的segment详细信息
/_cat/count #查看当前集群的doc数量
/_cat/count/{index} #查看指定索引的doc数量
/_cat/recovery #查看集群内每个shard的recovery过程.调整replica。
/_cat/recovery/{index}#查看指定索引shard的recovery过程
/_cat/health #查看集群当前状态:红、黄、绿
/_cat/pending_tasks #查看当前集群的pending task
/_cat/aliases #查看集群中所有alias信息,路由配置等
/_cat/aliases/{alias} #查看指定索引的alias信息
/_cat/thread_pool #查看集群各节点内部不同类型的threadpool的统计信息,
/_cat/plugins #查看集群各个节点上的plugin信息
/_cat/fielddata #查看当前集群各个节点的fielddata内存使用情况
/_cat/fielddata/{fields} #查看指定field的内存使用情况,里面传field属性对应的值
/_cat/nodeattrs #查看单节点的自定义属性
/_cat/repositories #输出集群中注册快照存储库
/_cat/templates #输出当前正在存在的模板信息
每个命令都支持使用?v参数,让输出内容表格显示表头; pretty则让输出缩进更规范
2、示例
1) 节点信息
curl -X GET "localhost:9200/_cat/nodes?v&pretty"
ip heap.percent ram.percent cpu load_1m load_5m load_15m node.role master name
172.18.0.4 52 97 6 0.02 0.11 0.28 mdi - es7_02
172.18.0.5 57 97 6 0.02 0.11 0.28 mdi * es7_01
-
heap.percent
堆内存占用百分比 -
ram.percent
内存占用百分比 -
cpu
CPU占用百分比 -
master
*
表示节点是集群中的主节点
-
name
节点名
2) 分片信息
curl -X GET "localhost:9200/_cat/shards?v&pretty"
index shard prirep state docs store ip node
.monitoring-es-7-2019.08.30 0 p STARTED 21333 11.8mb 172.18.0.5 es7_01
.monitoring-es-7-2019.08.30 0 r STARTED 21333 11.8mb 172.18.0.4 es7_02
goods-index 0 p STARTED 1 2.5mb 172.18.0.5 es7_01
goods-index 0 r STARTED 1 2.5mb 172.18.0.4 es7_02
.kibana_1 0 p STARTED 4 22.4kb 172.18.0.5 es7_01
.kibana_1 0 r STARTED 4 22.4kb 172.18.0.4 es7_02
-
index
索引名称 -
shard
分片序号 -
prirep
p
表示该分片是主分片
,r
表示该分片是复制分片
-
store
该分片占用存储空间 -
node
所属节点节点名
-
docs
分片存放的文档
数
3) 索引信息
curl -X GET "localhost:9200/_cat/indices?v"
health status index uuid pri rep docs.count docs.deleted store.size pri.store.size
green open goods-index NhqSRJWUQiu46tdOKol4wA 1 1 1 7018 5mb 2.5mb
green open .monitoring-es-7-2019.08.30 lVDNFDVdSXqqrn8CdI_XGg 1 1 21333 18920 23.6mb 11.8mb
green open .kibana_1 rvSlNVjJTsus80klzU19jQ 1 1 4 1 44.9kb 22.4kb
-
health
索引的健康状态 -
index
索引名 -
pri
索引主分片
数量 -
rep
索引复制分片
数 -
store.size
索引主分片
复制分片
总占用存储空间 -
pri.store.size
索引总占用空间, 不计算复制分片
占用空间
二、索引CRUD命令
1、查询索引
查询索引命令上面已经展示过了,这里再补充一些
条件过滤
_cat/indices?v&health=yellow #查询健康状态为yellow的索引
排序
_cat/indices?v&health=yellow&s=docs.count:desc #根据文档数量进行索引排序
索引详细信息
curl -X GET "localhost:9200/my_index/_stats?pretty" #索引详细信息
2、创建索引
PUT /student
{
"settings": {
"number_of_shards": 3,
"number_of_replicas": 1
},
"mappings": {
"properties": {
"name": {
"type":"text"
},
"country": {
"type":"keyword"
},
"age": {
"type":"integer"
},
"date": {
"type": "date",
"format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
}
}
}
}
创建成功
3、删除索引
curl -X DELETE "localhost:9200/index-name"
三、文档CRUD命令
在讲文档的CRUD之前我们要先理解 GET/PUT/POST/DELETE
POST /uri #创建
DELETE /uri/xxx #删除
PUT /uri/xxx #更新或创建
GET /uri/xxx #查看
思考
:POST和PUT的区别
1)在ES中,如果不确定文档的ID,那么就需要用POST,它可以自己生成唯一的文档ID。如果确定文档的ID,那么就可以用PUT,当然也可以用POST,它们都可以创建或修改文档(如果是修改,那么_version版本号提高1)
2)PUT、GET、DELETE是幂等的,而POST并不一定是幂等。如果你对POST也指定了文档ID,那它其实和PUT没啥区别,那它就是幂等。如果你没有指定文档ID那么就不是幂等操作了,因为同一数据,你执行多次POST,那么生成多个UUID的文档,
也就是每POST一次都会新增一条数据。
1、创建文档
1)PUT方式创建
PUT /student/_doc/1
{
"name": "徐小小",
"country": "杭州",
"age": "3",
"date": "2019-09-04"
}
运行结果
2)POST方式创建
POST不指定主键
POST /student/_doc
{
"name": "徐小小",
"country": "杭州",
"age": "3",
"date": "2019-09-04"
}
运行结果
POST指定主键ID
POST /student/_doc/88
{
"name": "徐小小",
"country": "杭州",
"age": "3",
"date": "2019-09-04"
}
运行结果
可以明显看出,POST也可以指定文档ID,如果指定文档ID,那么就和PUT没有区别。ID不存在则创建,存在则更新并且_version
版本+1.
2、文档查看
GET /student/_doc/1
如图
3、文档更新
商品PUT和POST执行的时候,如果指定的文档ID存在,那么就可以执行更新操作。不过它们执行的是全量更新,如果需要单独对某字段更新我们可以使用关键字_update
例如
POST /student/_update/1
{
"doc" : {
"age": 5
}
}
如图,发现age已经更新成功
4、文档删除
语法
DELETE /{index}/{type}/{id}