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

45 lines
1.1 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,console]
--------------------------------------------------
GET /_search
{
"query": {
"match_phrase": {
"message": "this is a test"
}
}
}
--------------------------------------------------
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,console]
--------------------------------------------------
GET /_search
{
"query": {
"match_phrase": {
"message": {
"query": "this is a test",
"analyzer": "my_analyzer"
}
}
}
}
--------------------------------------------------
This query also accepts `zero_terms_query`, as explained in <<query-dsl-match-query, `match` query>>.