Skip to content

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.md
index 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 (...)` options
In addition to the legacy keyword form (`EXPLAIN ANALYZE VERBOSE FORMAT tree SELECT ...`),