[ES|QL] Add MATCH_PHRASE (#127661)

* Initial commit of match_phrase

* Add MatchPhraseQueryTests

* First pass at CSV specs

* Update docs/changelog/127661.yaml

* Refactor so MatchPhrase doesn't use all fulltext test cases, just text only

* Fix tests

* Add some CSV test cases

* Fix test

* Update changelog

* Update tests

* Comment out MATCH_PHRASE in search-functions Markdown

* Minor PR feedback

* PR feedback - refactor/consolidate code

* Add some more tests

* Fix some tests

* [CI] Auto commit changes from spotless

* Fix tests

* PR feedback - add tests, support boost and numeric data

* Revert "PR feedback - add tests, support boost and numeric data"

This reverts commit 4e7a699.

* Apply testing/PR feedback outside numeric support only

* Regenerate docs

* Add negative test

* Update x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-phrase-function.csv-spec

Co-authored-by: Carlos Delgado <[email protected]>

* Update x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-phrase-function.csv-spec

Co-authored-by: Carlos Delgado <[email protected]>

* Update x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-phrase-function.csv-spec

Co-authored-by: Carlos Delgado <[email protected]>

* PR feedback

* Fix auto-commit error

* Regenerate docs

* Update x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/MatchPhrase.java

Co-authored-by: Liam Thompson <[email protected]>

* Remove non text field types

* Fake test data

* Remove tests that no longer should pass without ip/date/version support

* Put real data in score tests now that I was able to engineer a failure

* Realized the scoring test might be flakey because how it was written, updated

* PR feedback

* PR feedback

* [CI] Auto commit changes from spotless

* Add check to MatchPhrase tests

* Fix merge errors

* [CI] Auto commit changes from spotless

* Test generated docs

* Add additional verifier tests

---------

Co-authored-by: elasticsearchmachine <[email protected]>
Co-authored-by: Carlos Delgado <[email protected]>
Co-authored-by: Liam Thompson <[email protected]>

Author: 4 people

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/functions/description/match_phrase.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/_snippets/functions/examples/match_phrase.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
 % :::
 

docs/reference/query-languages/esql/_snippets/functions/functionNamedParams/match_phrase.md

@@ -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;
     }

docs/reference/query-languages/esql/_snippets/functions/layout/match_phrase.md

@@ -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);