Elasticsearch

Elasticsearch——基本命令

Elasticsearch基本命令

Posted by John Doe on 2023-08-07
Words 1.6k and Reading Time 7 Minutes
Viewed Times

1.ES集群相关命令

ES集群相关命令主要是_cat命令，所以这里详细讲解下该命令。

1、_cat命令

_cat系列提供了一系列查询Elasticsearch集群状态的接口。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/_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) 节点信息

1
2
3
4
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
  1. heap.percent 堆内存占用百分比
  2. ram.percent 内存占用百分比
  3. cpu CPU占用百分比
  4. master *表示节点是集群中的主节点
  5. name 节点名

2) 分片信息

1
2
3
4
5
6
7
8
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
  1. index 索引名称
  2. shard 分片序号
  3. prirep p表示该分片是主分片, r 表示该分片是复制分片
  4. store 该分片占用存储空间
  5. node 所属节点节点名
  6. docs 分片存放的文档数

3) 索引信息

1
2
3
4
5
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
  1. health 索引的健康状态
  2. index 索引名
  3. pri 索引主分片数量
  4. rep 索引复制分片 数
  5. store.size 索引主分片 复制分片 总占用存储空间
  6. pri.store.size 索引总占用空间, 不计算复制分片 占用空间

2.索引CRUD命令

2.1、查询索引

查询索引命令上面已经展示过了，这里再补充一些

条件过滤

1
_cat/indices?v&health=yellow   #查询健康状态为yellow的索引

排序

1
_cat/indices?v&health=yellow&s=docs.count:desc #根据文档数量进行索引排序

索引详细信息

1
curl -X GET "localhost:9200/my_index/_stats?pretty" #索引详细信息

2、创建索引

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
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"
            }
        }
    }
}

创建成功

es

3、删除索引

1
curl -X DELETE "localhost:9200/index-name"

3.文档CRUD命令

在讲文档的CRUD之前我们要先理解 GET/PUT/POST/DELETE

1
2
3
4
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一次都会新增一条数据。

3.1、创建文档

1）PUT方式创建

1
2
3
4
5
6
7
PUT  /student/_doc/1 
{
    "name": "徐小小",
    "country": "杭州",
    "age": "3",
    "date": "2019-09-04"
}

运行结果

es

2）POST方式创建

1
2
3
4
5
6
7
8
POST不指定主键
POST  /student/_doc
{
    "name": "徐小小",
    "country": "杭州",
    "age": "3",
    "date": "2019-09-04"
}

运行结果

es 

1
2
3
4
5
6
7
8
POST指定主键ID
POST  /student/_doc/88
{
    "name": "徐小小",
    "country": "杭州",
    "age": "3",
    "date": "2019-09-04"
}

运行结果

es

可以明显看出，POST也可以指定文档ID,如果指定文档ID,那么就和PUT没有区别。ID不存在则创建，存在则更新并且_version版本+1.

3.2、文档查看

1
GET  /student/_doc/1

如图

es

3.3、文档更新

商品PUT和POST执行的时候，如果指定的文档ID存在，那么就可以执行更新操作。不过它们执行的是全量更新，如果需要单独对某字段更新我们可以使用关键字_update

例如

1
2
3
4
5
6
POST /student/_update/1
{
   "doc" : {
      "age": 5
   }
}

POST /student/_update/1 { “doc” : { “age”: 5 } }

es

4、文档删除

1
DELETE /{index}/{type}/{id}

This is copyright.

...

...

00:00
00:00
FEATURED TAGS
Elasticsearch
FRIENDS