文章目錄

• • 1. Search Shards API 簡介

1. Search Shards API 簡介

search shard api返回行搜索執行請求的索引和分片。這可以為問題調試或通routing and shard preferences調優提供更多的有幫助的信息。

當使用過濾別名時，過濾器將作為在5.1.0中添加的索引部分[5.1.0]的一部分返回。

The search shards api returns the indices and shards that a search request would be executed against. This can give useful feedback for working out issues or planning optimizations with routing and shard preferences. When filtered aliases are used, the filter is returned as part of the indices section [5.1.0] Added in 5.1.0.

The index may be a single value, or comma-separated.

Usage
Full example:

GET /twitter/_search_shards

This will yield the following result:

{"nodes": ...,"indices" : {"twitter": { }},"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}]] }

And specifying the same request, this time with a routing value:

GET /twitter/_search_shards?routing=foo,bar

This will yield the following result:

{"nodes": ...,"indices" : {"twitter": { }},"shards": [[{"index": "twitter","node": "JklnKbD7Tyqi9TP3_Q_tBg","primary": true,"shard": 2,"state": "STARTED","allocation_id": {"id":"fMju3hd1QHWmWrIgFnI4Ww"},"relocating_node": null}],[{"index": "twitter","node": "JklnKbD7Tyqi9TP3_Q_tBg","primary": true,"shard": 3,"state": "STARTED","allocation_id": {"id":"0TvkCyF7TAmM1wHP4a42-A"},"relocating_node": null}]] }

This time the search will only be executed against two of the shards, because routing values have been specified.

All parameters:
routing

A comma-separated list of routing values to take into account when determining which shards a request would be executed against.

preference

Controls a preference of which shard replicas to execute the search request on. By default, the operation is randomized between the shard replicas. See the preference documentation for a list of all acceptable values.

local

A boolean value whether to read the cluster state locally in order to determine where shards are allocated instead of using the Master node’s cluster state.

超強干貨來襲 云風專訪：近40年碼齡，通宵達旦的技術人生

總結

以上是生活随笔為你收集整理的06.search_shard_api操作的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。