Skip to content

Docs: expand ES|QL LIKE backslash escaping#144889

Merged
wchaparro merged 4 commits intomainfrom
docs/esql-like-backslash-escaping-119081
Apr 15, 2026
Merged

Docs: expand ES|QL LIKE backslash escaping#144889
wchaparro merged 4 commits intomainfrom
docs/esql-like-backslash-escaping-119081

Conversation

@wchaparro
Copy link
Copy Markdown
Member

Fixes #119081

  • Extend WildcardLike @FunctionInfo.detailedDescription: correct * / ? wildcards, literal backslashes, Windows paths, and JSON/cURL escaping layers (without embedding """ inside a Java text block).
  • Add likeEscapingBackslashWindowsPath to string.csv-spec and wire it into the LIKE docs via load-esql-example.
  • Regenerate docs/reference/query-languages/esql/_snippets/operators/detailedDescription/like.md.

Tests: ./gradlew :x-pack:plugin:esql:test --tests org.elasticsearch.xpack.esql.expression.function.scalar.string.WildcardLikeTests and ./gradlew :x-pack:plugin:esql:test --tests '*CsvTests*likeEscapingBackslashWindowsPath*'.

Made with Cursor

Clarify * and ? wildcards, literal backslash and Windows paths,
JSON/cURL escaping layers, and add csv-spec + generated snippet.

Made-with: Cursor
Avoid """ inside Java text blocks (terminates delimiter).
Regenerate detailedDescription/like.md via WildcardLikeTests.

Made-with: Cursor
@wchaparro wchaparro requested a review from a team as a code owner March 24, 2026 20:26
@elasticsearchmachine elasticsearchmachine added needs:triage Requires assignment of a team area label v9.4.0 labels Mar 24, 2026
@wchaparro wchaparro added :Analytics/ES|QL AKA ESQL and removed needs:triage Requires assignment of a team area label labels Mar 24, 2026
@elasticsearchmachine elasticsearchmachine added the Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) label Mar 24, 2026
@elasticsearchmachine
Copy link
Copy Markdown
Collaborator

Pinging @elastic/es-analytical-engine (Team:Analytics)

@wchaparro wchaparro requested review from a team and alex-spies March 24, 2026 20:30
@wchaparro wchaparro added the >docs General docs changes label Mar 24, 2026
@wchaparro wchaparro self-assigned this Mar 24, 2026
@github-actions
Copy link
Copy Markdown
Contributor

🔍 Preview links for changed docs

⏳ Building and deploying preview... View progress

This comment will be updated with preview links when the build is complete.

@github-actions
Copy link
Copy Markdown
Contributor

ℹ️ 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?

Copy link
Copy Markdown
Member

@luigidellaquila luigidellaquila left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @wchaparro, LGTM

@wchaparro wchaparro merged commit 751462b into main Apr 15, 2026
36 checks passed
@wchaparro wchaparro deleted the docs/esql-like-backslash-escaping-119081 branch April 15, 2026 11:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

:Analytics/ES|QL AKA ESQL >docs General docs changes Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) v9.5.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ESQL: Expand docs on LIKE and backslash escaping a little

4 participants