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: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to