elastic · kderusso · Jun 12, 2025 · Jun 4, 2025 · Jun 9, 2025 · Jun 10, 2025
diff --git a/docs/changelog/127661.yaml b/docs/changelog/127661.yaml
@@ -0,0 +1,5 @@
+pr: 127661
+summary: Add MATCH_PHRASE
+area: ES|QL
+type: enhancement
+issues: []
diff --git a/docs/changelog/128925.yaml b/docs/changelog/128925.yaml
@@ -0,0 +1,5 @@
+pr: 128925
+summary: ES|QL - Add `match_phrase` full text function (tech preview)
+area: ES|QL
+type: enhancement
+issues: []
diff --git a/docs/reference/esql/functions/description/match_phrase.asciidoc b/docs/reference/esql/functions/description/match_phrase.asciidoc
diff --git a/docs/reference/esql/functions/examples/match_phrase.asciidoc b/docs/reference/esql/functions/examples/match_phrase.asciidoc
diff --git a/docs/reference/esql/functions/functionNamedParams/match_phrase.asciidoc b/docs/reference/esql/functions/functionNamedParams/match_phrase.asciidoc
diff --git a/docs/reference/esql/functions/kibana/definition/match_phrase.json b/docs/reference/esql/functions/kibana/definition/match_phrase.json
diff --git a/docs/reference/esql/functions/kibana/docs/match_phrase.md b/docs/reference/esql/functions/kibana/docs/match_phrase.md
diff --git a/docs/reference/esql/functions/layout/match_phrase.asciidoc b/docs/reference/esql/functions/layout/match_phrase.asciidoc
diff --git a/docs/reference/esql/functions/parameters/match_phrase.asciidoc b/docs/reference/esql/functions/parameters/match_phrase.asciidoc
diff --git a/docs/reference/esql/functions/signature/match_phrase.svg b/docs/reference/esql/functions/signature/match_phrase.svg
diff --git a/docs/reference/esql/functions/types/match_phrase.asciidoc b/docs/reference/esql/functions/types/match_phrase.asciidoc
diff --git a/server/src/main/java/org/elasticsearch/index/query/MatchPhraseQueryBuilder.java b/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;
     }

diff --git a/server/src/main/java/org/elasticsearch/index/query/ZeroTermsQueryOption.java b/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);