gengliangwang commented on a change in pull request #28097:
[SPARK-31325][SQL][Web UI] Control a plan explain mode in the events of SQL
listeners via SQLConf
URL: https://github.com/apache/spark/pull/28097#discussion_r402078311
##########
File path: docs/sql-migration-guide.md
##########
@@ -23,8 +23,11 @@ license: |
{:toc}
## Upgrading from Spark SQL 3.0 to 3.1
+
- Since Spark 3.1, grouping_id() returns long values. In Spark version 3.0
and earlier, this function returns int values. To restore the behavior before
Spark 3.0, you can set `spark.sql.legacy.integerGroupingId` to `true`.
+ - Since Spark 3.1, the `formatted` query explain mode is used in the events
(e.g., `SparkListenerSQLExecutionStart` and
`SparkListenerSQLAdaptiveExecutionUpdate`) of SQL listeners. To restore the
behavior before Spark 3.0, you can set
`spark.sql.queryDescriptionModeInListeners` to `extended`.
Review comment:
I think it is too internal to talk about the SQL listener and events like
`SparkListenerSQLExecutionStart` here.
How about
```
SQL UI data adopts the `formatted` mode for the query plan explain results.
```
----------------------------------------------------------------
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]
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
