Skip to content

[Internal]: ES|QL breaking change #1975

Open
@yctercero

Description

@yctercero

Description

ES|QL is introducing a breaking syntax change. While we don't believe it will affect a large number of users and is being documented by their team, we feel we should also add it as a breaking change for 8.19/9.1 as some user's rules could begin to fail.

What's changing:
Updating the grammar would mean that partial quoting would no longer be allowed; the following kinds of queries would be early rejected by ANTLR's lexer and parser (since they mix unquoted and quoted strings)

Prebuilt rules seem to be safe, but it would be any user custom rules utilizing old syntax that could begin seeing failures. We should point user to new syntax.

Per the linked issue, if user hit this error, they will:

Users will have to rewrite smaller parts of their affected ES|QL CCS queries to adapt to the newer syntax.

Resources

Ticket describing change: https://github.com/elastic/dev/issues/3166

Which documentation set does this change impact?

Elastic On-Prem and Cloud (all)

Feature differences

Please see the in depth details here: https://github.com/elastic/dev/issues/3166

What release is this request related to?

8.19/9.1

Serverless release

I believe it's already in.

Collaboration model

The documentation team

Point of contact.

Main contact: @yctercero
Stakeholders: @yctercero @approksiu

Metadata

Metadata

Assignees

No one assigned

    Labels

    Team:DeveloperIssues owned by the Developer Docs Team

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions