Search Shards API · Elasticsearch 5.4 中文文檔

# Search Shards API 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/getting-started.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/getting-started.html) 譯文鏈接 : [http://apache.wiki/display/Elasticsearch/Search+Shards+API](http://apache.wiki/display/Elasticsearch/Search+Shards+API) 貢獻者 : @Josh 搜索分片（**Shards**）**API?**返回將執行搜索請求的索引和分片。這可以提供有用的反饋用于解決問題或者計劃用 **routing** 和 **shard preference** 來優化。 **index** 和 **type** 參數可以為單個值，或者用逗號分隔。 ## 用法比如： ``` GET /twitter/_search_shards ``` 產生如下結果： ``` { "nodes": ..., "shards": [ [ { "index": "twitter", "node": "JklnKbD7Tyqi9TP3_Q_tBg", "primary": true, "shard": 0, "state": "STARTED", "allocation_id": {"id":"0TvkCyF7TAmM1wHP4a42-A"}, "relocating_node": null } ], [ { "index": "twitter", "node": "JklnKbD7Tyqi9TP3_Q_tBg", "primary": true, "shard": 1, "state": "STARTED", "allocation_id": {"id":"fMju3hd1QHWmWrIgFnI4Ww"}, "relocating_node": null } ], [ { "index": "twitter", "node": "JklnKbD7Tyqi9TP3_Q_tBg", "primary": true, "shard": 2, "state": "STARTED", "allocation_id": {"id":"Nwl0wbMBTHCWjEEbGYGapg"}, "relocating_node": null } ], [ { "index": "twitter", "node": "JklnKbD7Tyqi9TP3_Q_tBg", "primary": true, "shard": 3, "state": "STARTED", "allocation_id": {"id":"bU_KLGJISbW0RejwnwDPKw"}, "relocating_node": null } ], [ { "index": "twitter", "node": "JklnKbD7Tyqi9TP3_Q_tBg", "primary": true, "shard": 4, "state": "STARTED", "allocation_id": {"id":"DMs7_giNSwmdqVukF7UydA"}, "relocating_node": null } ] ] } ``` 指定相同的請求，這次用一個 **routing** 值： ``` GET /twitter/_search_shards?routing=foo,baz ``` 這將獲得以下結果： ``` { "nodes": ..., "shards": [ [ { "index": "twitter", "node": "JklnKbD7Tyqi9TP3_Q_tBg", "primary": true, "shard": 0, "state": "STARTED", "allocation_id": {"id":"0TvkCyF7TAmM1wHP4a42-A"}, "relocating_node": null } ], [ { "index": "twitter", "node": "JklnKbD7Tyqi9TP3_Q_tBg", "primary": true, "shard": 1, "state": "STARTED", "allocation_id": {"id":"fMju3hd1QHWmWrIgFnI4Ww"}, "relocating_node": null } ] ] } ``` ## 所有參數 | **routing** | 以逗號分隔的路由值列表考慮到當確定哪些碎片會反對執行的請求。 | | **preference** | 控制要對其執行搜索請求的分片副本的 **perference** 。默認情況下，操作在分片副本之間隨機化。有關所有可接受值的列表，請參閱 [preference](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-request-preference.html) 文檔。 | | **local** | 一個布爾值，是否在本地讀取集群狀態以便確定在何處分配碎片，而不是使用Master節點的集群狀態。 |