blob: cb098cd48b75da6b24f2618eed7bec646cbc3e40 (
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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
[[query-dsl-multi-match-query]]
=== Multi Match Query
The `multi_match` query builds further on top of the `match` query by
allowing multiple fields to be specified. The idea here is to allow to
more easily build a concise match type query over multiple fields
instead of using a relatively more expressive query by using multiple
match queries within a `bool` query.
The structure of the query is a bit different. Instead of a nested json
object defining the query field, there is a top json level field for
defining the query fields. Example:
[source,js]
--------------------------------------------------
{
"multi_match" : {
"query" : "this is a test",
"fields" : [ "subject", "message" ]
}
}
--------------------------------------------------
The `multi_match` query creates either a `bool` or a `dis_max` top level
query. Each field is a query clause in this top level query. The query
clause contains the actual query (the specified 'type' defines what
query this will be). Each query clause is basically a `should` clause.
[float]
[float]
==== Options
All options that apply on the `match` query also apply on the
`multi_match` query. The `match` query options apply only on the
individual clauses inside the top level query.
* `fields` - Fields to be used in the query.
* `use_dis_max` - Boolean indicating to either create a `dis_max` query
or a `bool` query. Defaults to `true`.
* `tie_breaker` - Multiplier value to balance the scores between lower
and higher scoring fields. Only applicable when `use_dis_max` is set to
true. Defaults to `0.0`.
The query accepts all the options that a regular `match` query accepts.
[float]
[float]
==== Boosting
The `multi_match` query supports field boosting via `^` notation in the
fields json field.
[source,js]
--------------------------------------------------
{
"multi_match" : {
"query" : "this is a test",
"fields" : [ "subject^2", "message" ]
}
}
--------------------------------------------------
In the above example hits in the `subject` field are 2 times more
important than in the `message` field.
|
