cloud-fan commented on a change in pull request #28274:
URL: https://github.com/apache/spark/pull/28274#discussion_r412003598
##########
File path: docs/configuration.md
##########
@@ -2622,11 +2622,27 @@ Please refer to the [Security](security.html) page for
available options on how
Spark subsystems.
-{% for static_file in site.static_files %}
- {% if static_file.name == 'generated-sql-configuration-table.html' %}
### Spark SQL
-{% include_relative generated-sql-configuration-table.html %}
+#### Runtime SQL Configuration
+
+Runtime SQL configurations inner-session, mutable Spark SQL configurations.
They can be set and queried by SET commands and rest by RESET command, or by
`SparkSession.conf`'s setter and getter methods.
+
+{% for static_file in site.static_files %}
+ {% if static_file.name == 'generated-runtime-sql-config-table.html' %}
+ {% include_relative generated-runtime-sql-config-table.html %}
+ {% break %}
+ {% endif %}
+{% endfor %}
+
+
+#### Static SQL Configuration
+
+Static SQL configurations are cross-session, immutable Spark SQL
configurations. External users can query the static sql config values via
`SparkSession.conf` or via set command, e.g. `SET spark.sql.extensions;`, but
cannot set/unset them.
Review comment:
We should also mention how to set them, e.g. by config file or by
setting `SparkConf` that is used to create `SparkSession`.
----------------------------------------------------------------
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:
us...@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscr...@spark.apache.org
For additional commands, e-mail: reviews-h...@spark.apache.org
