因個人愛好像寒,計劃對elasticsearch官方文檔部分章節(jié)做翻譯,統(tǒng)一發(fā)布至簡書博客瓜贾。特在此聲明:
- 所有翻譯內容禁止商業(yè)網(wǎng)站轉載(禁止使用此內容牟利)
- 歡迎elasticsearch使用者和愛好者轉載诺祸,但請注明出處。
- 希望讀者可以通過打賞或者評論的方式支持我阐虚。
涉及到的章節(jié)如下
Document APIs - 文檔相關的 API
Search APIs - 查詢相關的API
Aggregations - 聚合
cat APIs - 查看相關的 API
Cluster APIs - 集群相關的APIS
Query DSL 結構化查詢語句
Mapping 映射
Analysis 分詞
Index Modules - 索引模塊
翻譯宗旨是序臂,使涉及到的Elasticsearch文檔內容 中英文無差別使用蚌卤∈凳可能不逐句翻譯,可能會加入自己的理解逊彭,可能會打亂順序咸灿,可能會合并多篇章節(jié)。
QQ群:163861494 侮叮。這是我維護的一個QQ群避矢,用以做搜索技術交流。你可以加入囊榜,獲取最即時的信息审胸。
————————— Wonderful Content Start ————————
elasticsearch cat API
介紹
所有的cat 命令接受一個查詢字符串參數(shù)help,來查看請求頭和他提供的信息卸勺。/_cat 命令會列出所有可用的命令
curl 10.248.200.95:9200/_cat
=^.^=
/_cat/allocation
/_cat/shards
/_cat/shards/{index}
/_cat/master
/_cat/nodes
/_cat/indices
/_cat/indices/{index}
/_cat/segments
/_cat/segments/{index}
/_cat/count
/_cat/count/{index}
/_cat/recovery
/_cat/recovery/{index}
/_cat/health
/_cat/pending_tasks
/_cat/aliases
/_cat/aliases/{alias}
/_cat/thread_pool
/_cat/plugins
/_cat/fielddata
/_cat/fielddata/{fields}
/_cat/nodeattrs
/_cat/repositories
/_cat/snapshots/{repository}
通用參數(shù)
Verbose
每一個命令都接受查詢字符串v來返回詳細的輸出
[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/master
-XYVZvY8RBSgT_UTKnm4YA 10.248.200.95 10.248.200.95 95_new
[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/master?v
id host ip node
-XYVZvY8RBSgT_UTKnm4YA 10.248.200.95 10.248.200.95 95_new
Help
help 將輸出相關的列砂沛,
[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/master?help
id | | node id
host | h | host name
ip | | ip address
node | n | node name
headers
每一個命令接受一個查詢字符串h,指定返回哪些列
[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/nodes?h=ip,port,heapPercent,name
10.248.200.95 9300 46 95_new
可以使用通配符返回相關的多個列
[dmadmin@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/thread_pool?h=ip,bulk.*
10.248.200.95 fixed 0 4 0 50 0 4 1845717 4 4
格式化為數(shù)字
使用一些命令可以將一些類型格式化為數(shù)字來輸出曙求,比如byte,size,time 碍庵。這些類型默認的顯示格式對人類友好的映企。比如3.5mb 而不是3763212,這樣會影響排序静浴,當你需要排序的時候堰氓,可以修改。
舉個例子苹享,如果你想找到你集群中最大的索引(占用的磁盤最大)双絮,你可以使用/_cat/indices API來處理。你只需要做2件事
- 1得问,關閉human 模式
- 2掷邦,使用shell的sort命令
[etest@ip-10-248-200-95 ~]$ curl 10.248.200.95:9200/_cat/indices?bytes=b | sort -rnk8
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
105 948 105 948 0 0 86646 0 --:--:-- --:--:-- --:--:-- 94800
green open ware_index_20170306 1 0 13464943 408183 5262102838 5262102838
green open ware_index_20170508 1 0 3856275 561897 2507469280 2507469280
green open ware_index_20161124 1 0 4109687 1512573 2329827190 2329827190
green open .marvel-es-1-2017.06.15 1 0 154923 120 51517665 51517665
green open .marvel-es-1-2017.06.13 1 0 154924 96 51063984 51063984
green open .marvel-es-1-2017.06.14 1 0 154923 72 50911784 50911784
green open .marvel-es-1-2017.06.12 1 0 154923 37 50815402 50815402
green open .marvel-es-1-2017.06.10 1 0 154923 120 50641339 50641339
green open .marvel-es-1-2017.06.11 1 0 154887 48 49570329 49570329
green open .marvel-es-1-2017.06.16 1 0 56158 36 18935038 18935038
green open .kibana 1 0 2 0 19918 19918
green open .marvel-es-data-1 1 0 4 2 18084 18084
- time units 使用time
- size units 使用 size
- byte units 使用bytes參數(shù)
指定響應類型為text、json椭赋、smile抚岗、yaml或者cbor
[etest@ip-10-248-200-95 ~]$ curl "10.248.200.95:9200/_cat/indices?format=json&pretty"
[ {
"health" : "green",
"status" : "open",
"index" : ".marvel-es-1-2017.06.15",
"pri" : "1",
"rep" : "0",
"docs.count" : "154923",
"docs.deleted" : "120",
"store.size" : "49.1mb",
"pri.store.size" : "49.1mb"
}, {
"health" : "green",
"status" : "open",
"index" : ".marvel-es-1-2017.06.14",
"pri" : "1",
"rep" : "0",
"docs.count" : "154923",
"docs.deleted" : "72",
"store.size" : "48.5mb",
"pri.store.size" : "48.5mb"
} ]
當前支持的格式有:text,json,smile,yaml,cbor
有些格式,也可以通過http請求頭Accept來指定哪怔。
% curl '192.168.56.10:9200/_cat/indices?pretty' -H "Accept: application/json"
[
{
"pri.store.size": "650b",
"health": "yellow",
"status": "open",
"index": "twitter",
"pri": "5",
"rep": "1",
"docs.count": "0",
"docs.deleted": "0",
"store.size": "650b"
}
]
Sort
查詢字符串接收一個s參數(shù)宣蔚,可以指定排序方式,例如:desc,:asc认境,其中asc是默認的排序方式胚委。
例如s=column1,column2:desc,column3
GET _cat/templates?v&s=order:desc,template