搜索分片 API
编辑搜索分片 API编辑
返回搜索请求将要执行的索引和分片。
response = client.search_shards( index: 'my-index-000001' ) puts response
GET /my-index-000001/_search_shards
请求编辑
GET /<target>/_search_shards
描述编辑
搜索分片 API 返回搜索请求将要执行的索引和分片。这可以为解决问题或规划路由和分片首选项的优化提供有用的反馈。当使用过滤别名时，过滤器将作为 indices 部分的一部分返回。
路径参数编辑
-
<target> - (可选，字符串) 要搜索的数据流、索引和别名的逗号分隔列表。支持通配符 (
*)。要搜索所有数据流和索引，请省略此参数或使用*或_all。
查询参数编辑
-
allow_no_indices -
(可选，布尔值) 如果为
false，则如果任何通配符表达式、索引别名 或_all值仅针对缺少或关闭的索引，则请求将返回错误。即使请求针对其他打开的索引，此行为也适用。例如，如果索引以foo开头，但没有索引以bar开头，则针对foo*,bar*的请求将返回错误。默认为
true。 -
expand_wildcards -
(可选，字符串) 通配符模式可以匹配的索引类型。如果请求可以针对数据流，则此参数决定通配符表达式是否匹配隐藏的数据流。支持逗号分隔的值，例如
open,hidden。有效值为-
all - 匹配任何数据流或索引，包括 隐藏 的数据流或索引。
-
open - 匹配打开的、非隐藏的索引。也匹配任何非隐藏的数据流。
-
closed - 匹配关闭的、非隐藏的索引。也匹配任何非隐藏的数据流。数据流不能关闭。
-
hidden - 匹配隐藏的数据流和隐藏的索引。必须与
open、closed或两者结合使用。 -
none - 不接受通配符模式。
默认为
open。 -
-
ignore_unavailable - (可选，布尔值) 如果为
false，则如果请求针对缺少或关闭的索引，则请求将返回错误。默认为false。 -
local - (可选，布尔值) 如果为
true，则请求仅从本地节点检索信息。默认为false，这意味着信息是从主节点检索的。 -
preference - (可选，字符串) 指定应在哪个节点或分片上执行操作。默认情况下为随机。
-
routing - (可选，字符串) 用于将操作路由到特定分片的自定义值。
示例编辑
response = client.search_shards( index: 'my-index-000001' ) puts response
GET /my-index-000001/_search_shards
API 返回以下结果
{
"nodes": ...,
"indices" : {
"my-index-000001": { }
},
"shards": [
[
{
"index": "my-index-000001",
"node": "JklnKbD7Tyqi9TP3_Q_tBg",
"relocating_node": null,
"primary": true,
"shard": 0,
"state": "STARTED",
"allocation_id": {"id":"0TvkCyF7TAmM1wHP4a42-A"},
"relocation_failure_info" : {
"failed_attempts" : 0
}
}
],
[
{
"index": "my-index-000001",
"node": "JklnKbD7Tyqi9TP3_Q_tBg",
"relocating_node": null,
"primary": true,
"shard": 1,
"state": "STARTED",
"allocation_id": {"id":"fMju3hd1QHWmWrIgFnI4Ww"},
"relocation_failure_info" : {
"failed_attempts" : 0
}
}
],
[
{
"index": "my-index-000001",
"node": "JklnKbD7Tyqi9TP3_Q_tBg",
"relocating_node": null,
"primary": true,
"shard": 2,
"state": "STARTED",
"allocation_id": {"id":"Nwl0wbMBTHCWjEEbGYGapg"},
"relocation_failure_info" : {
"failed_attempts" : 0
}
}
],
[
{
"index": "my-index-000001",
"node": "JklnKbD7Tyqi9TP3_Q_tBg",
"relocating_node": null,
"primary": true,
"shard": 3,
"state": "STARTED",
"allocation_id": {"id":"bU_KLGJISbW0RejwnwDPKw"},
"relocation_failure_info" : {
"failed_attempts" : 0
}
}
],
[
{
"index": "my-index-000001",
"node": "JklnKbD7Tyqi9TP3_Q_tBg",
"relocating_node": null,
"primary": true,
"shard": 4,
"state": "STARTED",
"allocation_id": {"id":"DMs7_giNSwmdqVukF7UydA"},
"relocation_failure_info" : {
"failed_attempts" : 0
}
}
]
]
}
指定相同的请求，这次使用路由值
response = client.search_shards( index: 'my-index-000001', routing: 'foo,bar' ) puts response
GET /my-index-000001/_search_shards?routing=foo,bar
API 返回以下结果
{
"nodes": ...,
"indices" : {
"my-index-000001": { }
},
"shards": [
[
{
"index": "my-index-000001",
"node": "JklnKbD7Tyqi9TP3_Q_tBg",
"relocating_node": null,
"primary": true,
"shard": 2,
"state": "STARTED",
"allocation_id": {"id":"fMju3hd1QHWmWrIgFnI4Ww"},
"relocation_failure_info" : {
"failed_attempts" : 0
}
}
],
[
{
"index": "my-index-000001",
"node": "JklnKbD7Tyqi9TP3_Q_tBg",
"relocating_node": null,
"primary": true,
"shard": 3,
"state": "STARTED",
"allocation_id": {"id":"0TvkCyF7TAmM1wHP4a42-A"},
"relocation_failure_info" : {
"failed_attempts" : 0
}
}
]
]
}
由于指定了路由值，因此搜索仅在两个分片上执行。