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