[DOCS][ESQL] Update additional docs for CPS by leemthompo · Pull Request #144300 · elastic/elasticsearch

leemthompo · 2026-03-16T09:49:18Z

Follow up to #144206

Note

See https://www.elastic.co/docs/reference/query-languages/esql/esql-cross-serverless-projects for the main ESQL CPS page

Summary

New file:

project_routing.md — documents the project_routing SET parameter (serverless preview)
Updated files:

toc.md — includes project_routing.md
esql-cross-clusters.md — top note pointing serverless users to the CPS page; new H2 "Query across serverless projects" at the bottom with a link
esql-multi.md — added "Query across serverless projects" as a third bullet (serverless: preview)
esql-lookup-join.md — added CPS note alongside the Cross-cluster support section
esql-enrich-data.md — added note that ENRICH is not supported in CPS
esql-multi-index.md — added note pointing serverless users to CPS for qualified index expression syntax
from.md — tagged existing "Query remote clusters" as stack-only; added a parallel serverless entry for CPS
enrich.md — added a note under mode parameter that it doesn't apply in CPS

🤖

Claude Code helped

github-actions · 2026-03-16T09:51:45Z

🔍 Preview links for changed docs

github-actions · 2026-03-16T09:51:47Z

ℹ️ Important: Docs version tagging

👋 Thanks for updating the docs! Just a friendly reminder that our docs are now cumulative. This means all 9.x versions are documented on the same page and published off of the main branch, instead of creating separate pages for each minor version.

We use applies_to tags to mark version-specific features and changes.

Expand for a quick overview

When to use applies_to tags:

✅ At the page level to indicate which products/deployments the content applies to (mandatory)
✅ When features change state (e.g. preview, ga) in a specific version
✅ When availability differs across deployments and environments

What NOT to do:

❌ Don't remove or replace information that applies to an older version
❌ Don't add new information that applies to a specific version without an applies_to tag
❌ Don't forget that applies_to tags can be used at the page, section, and inline level

🤔 Need help?

Check out the cumulative docs guidelines
Reach out in the #docs Slack channel

docs/reference/query-languages/esql/esql-multi-index.md

quux00 · 2026-03-17T17:04:09Z

docs/reference/query-languages/esql/esql-enrich-data.md

 You can use `ENRICH` with remote clusters. For detailed information about cross-cluster enrichment syntax and configuration, refer to [ENRICH across clusters](/reference/query-languages/esql/esql-cross-clusters.md#ccq-enrich).

+::::{note}
+`ENRICH` is not supported in [cross-project search (CPS)](/reference/query-languages/esql/esql-cross-serverless-projects.md), because enrich policies are not available in {{serverless-short}}.


because enrich policies are not available in {{serverless-short}}.

Is this correct? I haven't heard that before, and based on this https://www.elastic.co/docs/api/doc/elasticsearch-serverless/operation/operation-enrich-get-policy that seems wrong?

Discussed with @idegtiarenko. He thinks that ENRICH with ES|QL does work in serverless. He will add tests to confirm. If that's right and once that's done, we should remove this statement

removing provisionally and the removing unavailable tag at top of page

@idegtiarenko confirmed that enrich with ES|QL does work in serverless: https://github.com/elastic/elasticsearch-serverless/pull/5976

elasticsearchmachine · 2026-03-24T07:54:22Z

Pinging @elastic/core-docs (Team:Docs)

luigidellaquila

Thanks @leemthompo, I had a quick look and there is at least one thing that needs to be fixed, see below

luigidellaquila · 2026-03-24T12:15:18Z

docs/reference/query-languages/esql/_snippets/commands/settings/project_routing.md

@@ -0,0 +1,22 @@
+### `project_routing` [esql-project_routing]


This is supposed to be a generated file.
We excluded it manually waiting for project_routing to become public, see https://github.com/elastic/elasticsearch/blob/main/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/plan/QuerySettingsTests.java#L260-L280

The correct way to do this is to update the definition here https://github.com/elastic/elasticsearch/blob/main/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plan/QuerySettings.java#L36 and re-run ProjectSettingsTests (after the manual override is removed)

If you want, I can take care of it, just let me know

@luigidellaquila ah ok cool thanks, yeah if you don't mind taking care of that, that would be great

we'll have to wait until CPS goes live to merge that :)

docs/reference/query-languages/esql/_snippets/commands/layout/from.md

shainaraskas

hello, looks lovely. here are some thoughts and feelings

docs/reference/query-languages/esql/esql-cross-clusters.md

docs/reference/query-languages/esql/esql-multi.md

shainaraskas · 2026-03-25T20:10:24Z

docs/reference/query-languages/esql/esql-multi-index.md

 ```


+In {{serverless-short}}, queries using an unqualified `<target>` automatically run across all linked projects with [cross-project search (CPS)](esql-cross-serverless-projects.md). Use `<project-alias>:<target>` to restrict the query to a specific project. {applies_to}`serverless: preview`


⚠️ if you're using es|ql within a space, then the space-level setting will restrict the projects your query will run against. it's also limited by the access of the user or key doing the querying. might want to link to this file when it makes sense to do so https://github.com/elastic/docs-content/pull/5498/files#diff-bf6a818a867ec4c2a275fbc52d0bebadbc6bf225fcfc4a876cc0cbda35323e2f

also might want to be clearer that in stack you have to specify your indices always

hopefully addressed by 7afa15a

with TODO for that final linkeroo

docs/reference/query-languages/esql/_snippets/commands/layout/from.md

docs/reference/query-languages/esql/esql-lookup-join.md

docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md

- enrich.md: remove incorrect note that mode param doesn't apply in CPS - from.md: state default behavior (all projects) in CPS section - esql-cross-clusters.md: make serverless note more explicit - esql-lookup-join.md: promote CPS to sibling section (not nested under cross-cluster) - esql-multi.md: merge upstream subquery addition; add projects to intro

…bullet

leemthompo added 2 commits March 13, 2026 15:41

[ESQL][DOCS] Add CPS page (unpublished for moment)

4fadd6e

[DOCS][ESQL] Update additional docs for CPS

18f57d3

leemthompo self-assigned this Mar 16, 2026

elasticsearchmachine added the v9.4.0 label Mar 16, 2026

github-actions bot deployed to docs-preview March 16, 2026 09:50 View deployment

Merge branch 'main' into cps-esql-docs-updates

543fe12

github-actions bot deployed to docs-preview March 16, 2026 09:56 View deployment

cleanup

272223c

github-actions bot deployed to docs-preview March 16, 2026 10:18 View deployment

Add FROM syntax example

714b68c

github-actions bot deployed to docs-preview March 16, 2026 10:25 View deployment

quux00 reviewed Mar 17, 2026

View reviewed changes

docs/reference/query-languages/esql/esql-multi-index.md Show resolved Hide resolved

quux00 reviewed Mar 17, 2026

View reviewed changes

leemthompo added 2 commits March 23, 2026 12:47

update serverless syntax and note

38a29ba

clarify enrich is serverless available

d572e77

github-actions bot deployed to docs-preview March 23, 2026 11:48 View deployment

leemthompo added >docs General docs changes Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) labels Mar 23, 2026

leemthompo marked this pull request as ready for review March 23, 2026 11:48

leemthompo requested a review from a team as a code owner March 23, 2026 11:48

elasticsearchmachine added needs:triage Requires assignment of a team area label and removed Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) labels Mar 23, 2026

leemthompo added Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) Team:Docs Meta label for docs team and removed needs:triage Requires assignment of a team area label labels Mar 24, 2026

elasticsearchmachine removed the Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) label Mar 24, 2026

Merge branch 'main' into cps-esql-docs-updates

0cb0566

github-actions bot deployed to docs-preview March 24, 2026 11:11 View deployment

luigidellaquila reviewed Mar 24, 2026

View reviewed changes

leemthompo added 2 commits March 25, 2026 17:44

use link to avoid duplication

09e7912

Remove project_routing.md snippet — this is a generated file

15637f9

shainaraskas approved these changes Mar 25, 2026

View reviewed changes

quux00 reviewed Mar 26, 2026

View reviewed changes

docs/reference/query-languages/esql/_snippets/commands/layout/enrich.md Outdated Show resolved Hide resolved

shainaraskas mentioned this pull request Mar 26, 2026

CPS tech preview elastic/docs-content#5498

Open

leemthompo mentioned this pull request Mar 31, 2026

[ESQL] Add a BY clause to CHANGE_POINT command #145210

Open

leemthompo added 3 commits April 7, 2026 10:43

rework multi-index verbiage

7afa15a

Merge main: resolve esql-multi.md conflict, keep serverless projects …

ef7f88d

…bullet

github-actions bot deployed to docs-preview April 7, 2026 08:55 View deployment

		@@ -0,0 +1,22 @@
		### `project_routing` [esql-project_routing]

		```


		In {{serverless-short}}, queries using an unqualified `<target>` automatically run across all linked projects with [cross-project search (CPS)](esql-cross-serverless-projects.md). Use `<project-alias>:<target>` to restrict the query to a specific project. {applies_to}`serverless: preview`

Conversation

leemthompo commented Mar 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

🤖

Uh oh!

github-actions bot commented Mar 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔍 Preview links for changed docs

Uh oh!

github-actions bot commented Mar 16, 2026

ℹ️ Important: Docs version tagging

When to use applies_to tags:

What NOT to do:

🤔 Need help?

Uh oh!

Uh oh!

quux00 Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

quux00 Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

leemthompo Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

quux00 Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

elasticsearchmachine commented Mar 24, 2026

Uh oh!

luigidellaquila left a comment

Choose a reason for hiding this comment

Uh oh!

luigidellaquila Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

leemthompo Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

shainaraskas left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

shainaraskas Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

shainaraskas Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

leemthompo Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

leemthompo commented Mar 16, 2026 •

edited

Loading

github-actions bot commented Mar 16, 2026 •

edited

Loading

quux00 Mar 17, 2026 •

edited

Loading

leemthompo Mar 23, 2026 •

edited

Loading