szehon-ho opened a new pull request, #58904: URL: https://github.com/apache/spark/pull/58904
### What changes were proposed in this pull request? Correct the Storage Partition Join guidance in the SQL performance tuning guide: - Remove `pushPartValues.enabled=true` as a prerequisite for `allowKeysSubsetOfPartitionKeys.enabled`. - Document that `allowCompatibleTransforms.enabled` requires `partiallyClusteredDistribution.enabled=false`. - Keep partial clustering at its default in the basic Iceberg example and describe it separately as optional skew tuning, including the extra reads that replication can cause. ### Why are the changes needed? The current table asks users to enable an unnecessary prerequisite for subset-key joins and omits an incompatible configuration combination. The basic example also enables partial clustering without explaining its replication cost. ### Does this PR introduce _any_ user-facing change? No. ### How was this patch tested? Checked the documented prerequisites against `EnsureRequirements.checkKeyGroupCompatible` and `KeyedShuffleSpec.canReduceKeys`, and reviewed the existing SPARK-48065 coverage in `KeyGroupedPartitioningSuite`. `git diff --check` passes. Documentation-only change; Spark test suites and the full documentation build were not run. ### Was this patch authored or co-authored using generative AI tooling? Generated-by: OpenAI Codex 0.143.0-alpha.32 -- 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]
