OpenSearch/docs/reference/query-dsl/match-phrase-query.asciidoc

47 lines
1.2 KiB
Plaintext

[[query-dsl-match-query-phrase]]
=== Match phrase query
++++
<titleabbrev>Match phrase</titleabbrev>
++++
The `match_phrase` query analyzes the text and creates a `phrase` query
out of the analyzed text. For example:
[source,js]
--------------------------------------------------
GET /_search
{
"query": {
"match_phrase" : {
"message" : "this is a test"
}
}
}
--------------------------------------------------
// CONSOLE
A phrase query matches terms up to a configurable `slop`
(which defaults to 0) in any order. Transposed terms have a slop of 2.
The `analyzer` can be set to control which analyzer will perform the
analysis process on the text. It defaults to the field explicit mapping
definition, or the default search analyzer, for example:
[source,js]
--------------------------------------------------
GET /_search
{
"query": {
"match_phrase" : {
"message" : {
"query" : "this is a test",
"analyzer" : "my_analyzer"
}
}
}
}
--------------------------------------------------
// CONSOLE
This query also accepts `zero_terms_query`, as explained in <<query-dsl-match-query, `match` query>>.