revise

Author: gengliangwang

sql/catalyst/src/main/scala/org/apache/spark/sql/internal/SQLConf.scala

@@ -2475,8 +2475,9 @@ object SQLConf {
   val LEGACY_PARSE_NULL_PARTITION_SPEC_AS_STRING_LITERAL =
     buildConf("spark.sql.legacy.parseNullPartitionSpecAsStringLiteral")
       .internal()
-      .doc("If it is set to true, Spark SQL parses the word `NULL` as the string literal 'NULL' " +
-        "in a partition specification, instead of a null partition value.")
+      .doc("If it is set to true, a null partition value is parsed as a string literal of its " +
+        "text representation, e.g., string 'null'. Otherwise, null partition values are parsed " +
+        "as they are.")
       .version("3.2.0")
       .booleanConf
       .createWithDefault(false)

sql/core/src/test/scala/org/apache/spark/sql/execution/command/v1/ShowPartitionsSuite.scala

@@ -89,7 +89,7 @@ trait ShowPartitionsSuiteBase extends command.ShowPartitionsSuiteBase {
       withTable(t) {
         sql(s"CREATE TABLE $t (col1 INT, p1 STRING) $defaultUsing PARTITIONED BY (p1)")
         sql(s"INSERT INTO TABLE $t PARTITION (p1 = null) SELECT 0")
-        checkAnswer(sql(s"SHOW PARTITIONS $t"), Row("p1=__HIVE_DEFAULT_PARTITION__"))
+        checkAnswer(sql(s"SHOW PARTITIONS $t"), Row("p1=null"))
         checkAnswer(sql(s"SHOW PARTITIONS $t PARTITION (p1 = null)"), Row("p1=null"))
       }
     }