Skip to content

[ES|QL] Add CATEGORIZE+BUCKET and grouped SAMPLE examples to function reference#149366

Open
charlotte-hoblik wants to merge 5 commits into
mainfrom
charlotte-esql-932
Open

[ES|QL] Add CATEGORIZE+BUCKET and grouped SAMPLE examples to function reference#149366
charlotte-hoblik wants to merge 5 commits into
mainfrom
charlotte-esql-932

Conversation

@charlotte-hoblik
Copy link
Copy Markdown
Contributor

Closes https://github.com/elastic/docs-content-internal/issues/932

Adds tested examples to the CATEGORIZE and SAMPLE ES|QL function reference pages.

CATEGORIZE: adds a second example combining CATEGORIZE with BUCKET in the same BY clause to group log message patterns by time interval. Addresses the user question raised in the issue.

SAMPLE: adds a grouped variant showing both single-value and multivalue array return behavior in one result table. Replaces the existing employees-based example with a sample_data-based one for page-wide dataset consistency.

@charlotte-hoblik charlotte-hoblik self-assigned this May 19, 2026
@charlotte-hoblik charlotte-hoblik requested a review from a team as a code owner May 19, 2026 08:30
@charlotte-hoblik charlotte-hoblik added >docs General docs changes Team:Docs Meta label for docs team documentation labels May 19, 2026
@elasticsearchmachine
Copy link
Copy Markdown
Collaborator

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

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 19, 2026

🔍 Preview links for changed docs

@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?

@charlotte-hoblik charlotte-hoblik added the Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) label May 19, 2026
@elasticsearchmachine elasticsearchmachine removed the Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) label May 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes documentation Team:Docs Meta label for docs team v9.5.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants