Search Shards API · my-elasticsearch-cn

# Search Shards API 搜索分片（**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節點的集群狀態。 |