Apache DataFusion SQL Query Engine
docs: mention output_rows_skew on partitioned operators in explain-usage (#26048)
Lía Adriana9f81b78aadaf
diff --git a/docs/source/user-guide/explain-usage.md b/docs/source/user-guide/explain-usage.mdindex 6654ca3e92..83ff5c3e54 100644--- a/docs/source/user-guide/explain-usage.md+++ b/docs/source/user-guide/explain-usage.md@@ -243,6 +243,12 @@ When predicate pushdown is enabled, `DataSourceExec` with `ParquetSource` gains- `row_pushdown_eval_time`: time spent evaluating row-level filters- `page_index_eval_time`: time required to evaluate the page index filters+`output_rows_skew` is also reported by operators that execute in multiple+partitions: `RepartitionExec`, `HashJoinExec`, `AggregateExec`,+`BoundedWindowAggExec` and `WindowAggExec`. It shows how evenly their output+rows are spread across partitions, which helps spot data skew (for example, a+hot join or grouping key). With a single partition the skew is always `0%`.+## Postgres-style `EXPLAIN (...)` optionsIn addition to the legacy keyword form (`EXPLAIN ANALYZE VERBOSE FORMAT tree SELECT ...`),