You are viewing a plain text version of this content. The canonical link for it is here.
Posted to github@datafusion.apache.org by "andygrove (via GitHub)" <gi...@apache.org> on 2026/05/01 17:19:02 UTC
[PR] docs: document experimental Adaptive Query Execution in tuning guide [datafusion-ballista]
andygrove opened a new pull request, #1645:
URL: https://github.com/apache/datafusion-ballista/pull/1645
# Which issue does this PR close?
Related to #387.
# Rationale for this change
The adaptive query execution (AQE) planner landed in #1372 but is not yet covered in the user guide. Without documentation, users have no way to discover the feature, learn how to enable it, or understand its current scope and limitations. Documenting it now also makes it explicit that the feature is experimental and not production-ready.
# What changes are included in this PR?
Adds an "Adaptive Query Execution (Experimental)" section to `docs/source/user-guide/tuning-guide.md` covering:
- A short description of what AQE does and how it differs from the static planner
- How to enable it via `ballista.planner.adaptive.enabled`
- A configuration table for the two AQE session keys (`enabled`, `planner_pass`)
- The two adaptive optimizations currently implemented (join reordering and empty stage elimination)
- The known limitations (executor failure handling, dynamic partition coalescing, hash to sort-merge join switch, streaming to hash aggregation switch)
- A pointer to the tracking issue (#387)
# Are there any user-facing changes?
Documentation only. No code or behavior changes.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@datafusion.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: github-unsubscribe@datafusion.apache.org
For additional commands, e-mail: github-help@datafusion.apache.org
Re: [PR] docs: document experimental Adaptive Query Execution in tuning guide [datafusion-ballista]
Posted by "andygrove (via GitHub)" <gi...@apache.org>.
andygrove merged PR #1645:
URL: https://github.com/apache/datafusion-ballista/pull/1645
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@datafusion.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: github-unsubscribe@datafusion.apache.org
For additional commands, e-mail: github-help@datafusion.apache.org