This is an automated email from the ASF dual-hosted git repository.
pan3793 pushed a commit to branch branch-4.x
in repository https://gitbox.apache.org/repos/asf/spark.git
The following commit(s) were added to refs/heads/branch-4.x by this push:
new 5f1729343e2b [MINOR][DOC][SQL] Fix minor gaps and problems in Thrift
server docs
5f1729343e2b is described below
commit 5f1729343e2b3a4ad78b99fde957b6969f72ca0a
Author: Nicholas Chammas <[email protected]>
AuthorDate: Thu Aug 13 11:51:16 2026 +0800
[MINOR][DOC][SQL] Fix minor gaps and problems in Thrift server docs
### What changes were proposed in this pull request?
Mention `sbin/stop-thriftserver.sh` in the SQL docs on the Thrift server.
Flesh out the Hive config example just a tiny bit.
Also fix some minor whitespace and Markdown style issues.
### Why are the changes needed?
The documentation currently mentions `start-thriftserver.sh`. It seems
weird not to also mention the matching script to stop the service.
The existing `%s` is confusing by itself. Users may not immediately
understand it's supposed to be a substitution marker.
### Does this PR introduce _any_ user-facing change?
Documentation only.
### How was this patch tested?
Built the docs with `SKIP_API=1 bundle exec jekyll serve` and reviewed them
locally.
### Was this patch authored or co-authored using generative AI tooling?
No.
Closes #57970 from nchammas/sql-doc-tweak.
Authored-by: Nicholas Chammas <[email protected]>
Signed-off-by: Cheng Pan <[email protected]>
(cherry picked from commit 293ca0c35b53e5c9a0c3ba5d4e664b52b0d2a47a)
Signed-off-by: Cheng Pan <[email protected]>
---
docs/sql-distributed-sql-engine.md | 25 ++++++++++++++++---------
1 file changed, 16 insertions(+), 9 deletions(-)
diff --git a/docs/sql-distributed-sql-engine.md
b/docs/sql-distributed-sql-engine.md
index ae8fd9c7211b..53fc8c1b5f77 100644
--- a/docs/sql-distributed-sql-engine.md
+++ b/docs/sql-distributed-sql-engine.md
@@ -40,23 +40,23 @@ specify Hive properties. You may run
`./sbin/start-thriftserver.sh --help` for a
all available options. By default, the server listens on localhost:10000. You
may override this
behaviour via either environment variables, i.e.:
-{% highlight bash %}
+```bash
export HIVE_SERVER2_THRIFT_PORT=<listening-port>
export HIVE_SERVER2_THRIFT_BIND_HOST=<listening-host>
./sbin/start-thriftserver.sh \
--master <master-uri> \
...
-{% endhighlight %}
+```
or system properties:
-{% highlight bash %}
+```bash
./sbin/start-thriftserver.sh \
--hiveconf hive.server2.thrift.port=<listening-port> \
--hiveconf hive.server2.thrift.bind.host=<listening-host> \
- --master <master-uri>
+ --master <master-uri> \
...
-{% endhighlight %}
+```
Now you can use beeline to test the Thrift JDBC/ODBC server:
@@ -85,13 +85,20 @@ To test, use beeline to connect to the JDBC/ODBC server in
http mode with:
beeline> !connect
jdbc:hive2://<host>:<port>/<database>;transportMode=http;httpPath=<http_endpoint>
-If you closed a session and do CTAS, you must set `fs.%s.impl.disable.cache`
to true in `hive-site.xml`.
-See more details in
[[SPARK-21067]](https://issues.apache.org/jira/browse/SPARK-21067).
+If you closed a session and do CTAS, you must set
`fs.<scheme>.impl.disable.cache` to `true` in `hive-site.xml`. `<scheme>` is
the Hadoop filesystem you are using, like `hdfs`, `s3a`, etc. For example:
+
+ fs.hdfs.impl.disable.cache=true
+
+See more details in
[SPARK-21067](https://issues.apache.org/jira/browse/SPARK-21067).
+
+To stop the Thrift JDBC/ODBC server, run:
+
+ ./sbin/stop-thriftserver.sh
## Running the Spark SQL CLI
To use the Spark SQL command line interface (CLI) from the shell:
./bin/spark-sql
-
-For details, please refer to [Spark SQL
CLI](sql-distributed-sql-engine-spark-sql-cli.html)
+
+For details, please refer to [Spark SQL
CLI](sql-distributed-sql-engine-spark-sql-cli.html).
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
