Elasticsearch(5) --- 基本命令(集群相關命令、索引CRUD命令、文檔CRUD命令)

Elasticsearch(5)--- 基本命令

說明：該博客對於的Elasticsearch 的版本為7.3。

這篇博客的命令分為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

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

1. index 索引名稱
2. shard 分片序號
3. prirep p表示該分片是主分片, r 表示該分片是復制分片
4. store 該分片占用存儲空間
5. node 所屬節點節點名
6. 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

1. health 索引的健康狀態
2. index 索引名
3. pri 索引主分片數量
4. rep 索引復制分片 數
5. store.size 索引主分片 復制分片 總占用存儲空間
6. 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}

參考

1、Elasticsearch核心技術與實戰---阮一鳴(eBay Pronto平台技術負責人

2、ElasticSearch常用命令

3、Elasticsearch 狀態查詢Cat接口

4、文檔操作基本命令

5、ElasticSearch批量操作相關命令

 我相信，無論今后的道路多么坎坷，只要抓住今天，遲早會在奮斗中嘗到人生的甘甜。抓住人生中的一分一秒，勝過虛度中的一月一年！(9）