Skip to content

docs(esql): document three-valued logic for AND, OR, and NOT#151139

Open
wilmerdooley wants to merge 1 commit into
elastic:mainfrom
wilmerdooley:oss/issue-129314
Open

docs(esql): document three-valued logic for AND, OR, and NOT#151139
wilmerdooley wants to merge 1 commit into
elastic:mainfrom
wilmerdooley:oss/issue-129314

Conversation

@wilmerdooley

Copy link
Copy Markdown

Description

The ES|QL reference page for logical operators only listed the supported operators without explaining how they handle null operands. This has led to repeated bug reports (most recently #129125) about WHERE commands filtering out rows unexpectedly when fields are null.

This change expands docs/reference/query-languages/esql/_snippets/operators/logical.md to describe the three-valued logic used by AND, OR, and NOT, including 3x3 / 3x1 truth tables and an example based on the issue.

Resolves #129314

Signed-off-by: wilmerdooley <wilmerdooley1@gmail.com>
@wilmerdooley wilmerdooley requested a review from a team as a code owner June 12, 2026 23:27
@elasticsearchmachine elasticsearchmachine added external-contributor Pull request authored by a developer outside the Elasticsearch team needs:triage Requires assignment of a team area label v9.5.0 labels Jun 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

external-contributor Pull request authored by a developer outside the Elasticsearch team needs:triage Requires assignment of a team area label v9.5.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ESQL: document boolean operators' behavior on NULLs

2 participants