Skip to content

docs: explain nondeterministic row ordering without ORDER BY (#7373)#21019

Open
Xavrir wants to merge 1 commit intoapache:mainfrom
Xavrir:docs/issue-7373-result-ordering
Open

docs: explain nondeterministic row ordering without ORDER BY (#7373)#21019
Xavrir wants to merge 1 commit intoapache:mainfrom
Xavrir:docs/issue-7373-result-ordering

Conversation

@Xavrir
Copy link

@Xavrir Xavrir commented Mar 18, 2026

Summary

  • document that DataFusion only guarantees row order when a query uses ORDER BY
  • add notes to the SQL SELECT guide for joins, GROUP BY, and the ORDER BY clause itself
  • add an FAQ entry for users who see the same rows come back in a different order between runs

Testing

  • docs-only change; no code paths changed

Closes #7373

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Mar 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document non-deterministic ordering of joining, group by, etc.

1 participant