HyukjinKwon commented on a change in pull request #28274:
URL: https://github.com/apache/spark/pull/28274#discussion_r412895559
##########
File path: docs/configuration.md
##########
@@ -2622,11 +2622,32 @@ 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 are per-session, mutable Spark SQL configurations.
They can be set with initial values by the config file
+and command-line options with `--conf/-c` prefixed, or by setting `SparkConf`
that are used to create `SparkSession`.
+Also, they can be set and queried by SET commands and rest to their initial
values by RESET command,
+or by `SparkSession.conf`'s setter and getter methods in runtime.
+
+{% 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. They can be set with final values by the config file
+and command-line options with `--conf/-c` prefixed, or by setting `SparkConf`
that are used to create `SparkSession`.
Review comment:
You could mention `spark-default.conf` too, but it's okay.
----------------------------------------------------------------
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]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
