dongjoon-hyun commented on a change in pull request #27653: [MINOR][SQL] Add a
comment for `removedSQLConfigs`
URL: https://github.com/apache/spark/pull/27653#discussion_r382179037
##########
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:
Shall we describe in a simpler and positive words like `because the config
is no-op technically` instead of `because any of its values does not impact on
the behavior of Spark`?
----------------------------------------------------------------
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]