blob: 0a71a363808d5a6ca6d86aee9e9fae50acca9e7a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
|
[[search-request-preference]]
=== Preference
Controls a `preference` of which shard replicas to execute the search
request on. By default, the operation is randomized between the shard
replicas.
The `preference` can be set to:
[horizontal]
`_primary`::
The operation will go and be executed only on the primary
shards.
`_primary_first`::
The operation will go and be executed on the primary
shard, and if not available (failover), will execute on other shards.
`_local`::
The operation will prefer to be executed on a local
allocated shard if possible.
`_only_node:xyz`::
Restricts the search to execute only on a node with
the provided node id (`xyz` in this case).
`_prefer_node:xyz`::
Prefers execution on the node with the provided
node id (`xyz` in this case) if applicable.
`_shards:2,3`::
Restricts the operation to the specified shards. (`2`
and `3` in this case). This preference can be combined with other
preferences but it has to appear first: `_shards:2,3;_primary`
Custom (string) value::
A custom value will be used to guarantee that
the same shards will be used for the same custom value. This can help
with "jumping values" when hitting different shards in different refresh
states. A sample value can be something like the web session id, or the
user name.
|
