cloud-fan 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_r402086061
 
 

 ##########
 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:
   We only add a migration guide if we change behavior BY DEFAULT.
   
   We can mention it in release notes though, to promote this feature.

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

Reply via email to