aboutsummaryrefslogtreecommitdiff
path: root/docs/sql-programming-guide.md
diff options
context:
space:
mode:
authorCheng Lian <lian@databricks.com>2015-11-17 11:17:52 -0800
committerMichael Armbrust <michael@databricks.com>2015-11-17 11:17:52 -0800
commit7b1407c7b95c43299a30e891748824c4bc47e43b (patch)
tree5fbeef381ca979fc7a4ce3deec9f5c69d6d6c2cc /docs/sql-programming-guide.md
parente8833dd12c71b23a242727e86684d2d868ff84b3 (diff)
downloadspark-7b1407c7b95c43299a30e891748824c4bc47e43b.tar.gz
spark-7b1407c7b95c43299a30e891748824c4bc47e43b.tar.bz2
spark-7b1407c7b95c43299a30e891748824c4bc47e43b.zip
[SPARK-11089][SQL] Adds option for disabling multi-session in Thrift server
This PR adds a new option `spark.sql.hive.thriftServer.singleSession` for disabling multi-session support in the Thrift server. Note that this option is added as a Spark configuration (retrieved from `SparkConf`) rather than Spark SQL configuration (retrieved from `SQLConf`). This is because all SQL configurations are session-ized. Since multi-session support is by default on, no JDBC connection can modify global configurations like the newly added one. Author: Cheng Lian <lian@databricks.com> Closes #9740 from liancheng/spark-11089.single-session-option.
Diffstat (limited to 'docs/sql-programming-guide.md')
-rw-r--r--docs/sql-programming-guide.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/sql-programming-guide.md b/docs/sql-programming-guide.md
index 6e02d6564b..e347754055 100644
--- a/docs/sql-programming-guide.md
+++ b/docs/sql-programming-guide.md
@@ -2051,6 +2051,20 @@ options.
# Migration Guide
+## Upgrading From Spark SQL 1.5 to 1.6
+
+ - From Spark 1.6, by default the Thrift server runs in multi-session mode. Which means each JDBC/ODBC
+ connection owns a copy of their own SQL configuration and temporary function registry. Cached
+ tables are still shared though. If you prefer to run the Thrift server in the old single-session
+ mode, please set option `spark.sql.hive.thriftServer.singleSession` to `true`. You may either add
+ this option to `spark-defaults.conf`, or pass it to `start-thriftserver.sh` via `--conf`:
+
+ {% highlight bash %}
+ ./sbin/start-thriftserver.sh \
+ --conf spark.sql.hive.thriftServer.singleSession=true \
+ ...
+ {% endhighlight %}
+
## Upgrading From Spark SQL 1.4 to 1.5
- Optimized execution using manually managed memory (Tungsten) is now enabled by default, along with