[ES|QL] Add MATCH_PHRASE

docs/changelog/127661.yaml

@@ -0,0 +1,5 @@
+pr: 127661
+summary: Add MATCH_PHRASE
+area: ES|QL
+type: enhancement
+issues: []

docs/reference/query-languages/esql/_snippets/lists/search-functions.md

@@ -1,4 +1,7 @@
 * [preview] [`KQL`](../../functions-operators/search-functions.md#esql-kql)
 * [preview] [`MATCH`](../../functions-operators/search-functions.md#esql-match)
+  % * [preview] [
+  `MATCH_PHRASE`](../../functions-operators/search-functions.md#esql-match-phrase)
 * [preview] [`QSTR`](../../functions-operators/search-functions.md#esql-qstr)
-% * [preview] [`TERM`](../../functions-operators/search-functions.md#esql-term)
+  % * [preview] [
+  `TERM`](../../functions-operators/search-functions.md#esql-term)

docs/reference/query-languages/esql/functions-operators/search-functions.md

@@ -6,33 +6,46 @@ mapped_pages:
 
 # {{esql}} Search functions [esql-search-functions]
 
-Use these functions for [full-text search](docs-content://solutions/search/full-text.md) and [semantic search](docs-content://solutions/search/semantic-search/semantic-search-semantic-text.md). 
+Use these functions
+for [full-text search](docs-content://solutions/search/full-text.md)
+and [semantic search](docs-content://solutions/search/semantic-search/semantic-search-semantic-text.md).
 
-Get started with {{esql}} for search use cases with our [hands-on tutorial](docs-content://solutions/search/esql-search-tutorial.md).
+Get started with {{esql}} for search use cases with
+our [hands-on tutorial](docs-content://solutions/search/esql-search-tutorial.md).
 
-Full text functions can be used to match [multivalued fields](/reference/query-languages/esql/esql-multivalued-fields.md). A multivalued field that contains a value that matches a full text query is considered to match the query.
+Full text functions can be used to
+match [multivalued fields](/reference/query-languages/esql/esql-multivalued-fields.md).
+A multivalued field that contains a value that matches a full text query is
+considered to match the query.
 
-Full text functions are significantly more performant for text search use cases on large data sets than using pattern matching or regular expressions with `LIKE` or `RLIKE`
+Full text functions are significantly more performant for text search use cases
+on large data sets than using pattern matching or regular expressions with
+`LIKE` or `RLIKE`
 
-See [full text search limitations](/reference/query-languages/esql/limitations.md#esql-limitations-full-text-search) for information on the limitations of full text search.
+See [full text search limitations](/reference/query-languages/esql/limitations.md#esql-limitations-full-text-search)
+for information on the limitations of full text search.
 
 {{esql}} supports these full-text search functions:
 
 :::{include} ../_snippets/lists/search-functions.md
 :::
 
-
 :::{include} ../_snippets/functions/layout/kql.md
 :::
 
 :::{include} ../_snippets/functions/layout/match.md
 :::
 
+% MATCH_PHRASE is currently hidden
+% :::{include} ../_snippets/functions/layout/match_phrase.md
+% :::
+
 :::{include} ../_snippets/functions/layout/qstr.md
 :::
 
 % TERM is currently a hidden feature
-% To make it visible again, uncomment this and the line in lists/search-functions.md
+% To make it visible again, uncomment this and the line in
+lists/search-functions.md
 % :::{include} ../_snippets/functions/layout/term.md
 % :::
 

server/src/main/java/org/elasticsearch/index/query/MatchPhraseQueryBuilder.java

@@ -129,6 +129,11 @@ public MatchPhraseQueryBuilder zeroTermsQuery(ZeroTermsQueryOption zeroTermsQuer
         return this;
     }
 
+    public MatchPhraseQueryBuilder zeroTermsQuery(String zeroTermsQueryString) {
+        ZeroTermsQueryOption zeroTermsQueryOption = ZeroTermsQueryOption.readFromString(zeroTermsQueryString);
+        return zeroTermsQuery(zeroTermsQueryOption);
+    }
+
     public ZeroTermsQueryOption zeroTermsQuery() {
         return this.zeroTermsQuery;
     }

server/src/main/java/org/elasticsearch/index/query/ZeroTermsQueryOption.java

@@ -55,6 +55,15 @@ public static ZeroTermsQueryOption readFromStream(StreamInput in) throws IOExcep
         throw new ElasticsearchException("unknown serialized type [" + ord + "]");
     }
 
+    public static ZeroTermsQueryOption readFromString(String input) {
+        for (ZeroTermsQueryOption zeroTermsQuery : ZeroTermsQueryOption.values()) {
+            if (zeroTermsQuery.name().equalsIgnoreCase(input)) {
+                return zeroTermsQuery;
+            }
+        }
+        throw new ElasticsearchException("unknown serialized type [" + input + "]");
+    }
+
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVInt(this.ordinal);