cloud-fan commented on a change in pull request #32932:
URL: https://github.com/apache/spark/pull/32932#discussion_r656799496



##########
File path: docs/sql-ref-syntax-qry-select-hints.md
##########
@@ -51,6 +51,10 @@ specified, multiple nodes are inserted into the logical 
plan, but the leftmost h
 
   The `REPARTITION_BY_RANGE` hint can be used to repartition to the specified 
number of partitions using the specified partitioning expressions. It takes 
column names and an optional partition number as parameters.
 
+* **REPARTITION_BY_AQE**

Review comment:
       The doc here is pretty bad...
   
   ```
   **REBALANCE_PARTITIONS** 
   
   The `REBALANCE_PARTITIONS` hint can be used to rebalance the query result 
output partitions, so that
   every partition is of a reasonable size (not too small and not too big). It 
can take column names as
   parameters, and try its best to partition the query result by these columns. 
This is a best-effort: if
   there are skews, Spark will split the skewed partitions, to make these 
partitions not too big. This
   hint is useful when you need to write the result of this query to a table, 
to avoid too small/big files.
   This hint is ignored if AQE is not enabled.
   ```




-- 
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.

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