HyukjinKwon commented on a change in pull request #27653: [MINOR][SQL] Add a
comment for `removedSQLConfigs`
URL: https://github.com/apache/spark/pull/27653#discussion_r382356996
##########
File path:
sql/catalyst/src/main/scala/org/apache/spark/sql/internal/SQLConf.scala
##########
@@ -2254,6 +2254,14 @@ object SQLConf {
* The map contains info about removed SQL configs. Keys are SQL config
names,
* map values contain extra information like the version in which the config
was removed,
* config's default value and a comment.
+ *
+ * Removed SQL config should be added to the map iff its non-default value
changed
+ * the behavior. Any removed config of `removedSQLConfigs` which set to a
non-default
+ * value raises an exception propagated to user's app. For example, the SQL
config
+ * `spark.sql.variable.substitute.depth` was deprecated since Spark 2.1 and
not
+ * used in Spark 2.4, so, it should not be placed here because any of its
values
+ * does not impact on the behavior of Spark 3.0. And this makes migrations
to new
Review comment:
Yeah, I was about to point this out. Let's make the description shorter and
simpler.
----------------------------------------------------------------
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]