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_r402081659
##########
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:
It's sort of behavior change and it worth mentioning the new configuration.
I think it is fine to have the migration guide.
----------------------------------------------------------------
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]
