elasticsearch/docs/reference/query-languages/query-dsl-match-query-phrase.md

navigation_title	mapped_pages
Match phrase	https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-match-query-phrase.html

Match phrase query [query-dsl-match-query-phrase]

The match_phrase query analyzes the text and creates a phrase query out of the analyzed text. For example:

GET /_search
{
  "query": {
    "match_phrase": {
      "message": "this is a test"
    }
  }
}

Parameters for <field> [match-phrase-field-params]

query

(Required) Text, number, boolean value or date you wish to find in the provided <field>.

analyzer

(Optional, string) Analyzer used to convert the text in the query value into tokens. Defaults to the index-time analyzer mapped for the <field>. If no analyzer is mapped, the index’s default analyzer is used.

slop

(Optional, integer) Maximum number of positions allowed between matching tokens. Defaults to 0. Transposed terms have a slop of 2.

zero_terms_query

(Optional, string) Indicates whether no documents are returned if the analyzer removes all tokens, such as when using a stop filter. Valid values are:

none (Default)

No documents are returned if the analyzer removes all tokens.

all

Returns all documents, similar to a match_all query.

A phrase query matches terms up to a configurable slop (which defaults to 0) in any order. Transposed terms have a slop of 2.

Analyzer in the match phrase query [query-dsl-match-query-phrase-analyzer]

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:

GET /_search
{
  "query": {
    "match_phrase": {
      "message": {
        "query": "this is a test",
        "analyzer": "my_analyzer"
      }
    }
  }
}