kyuubi/docs
zhouyifan279 d9a26c3b09 [KYUUBI #5480] Support setting kyuubi hive jdbc client protocol version
### _Why are the changes needed?_
When using Kyuubi Hive JDBC to Hive Server2, TProtocolVersion.HIVE_CLI_SERVICE_PROTOCOL_V10 is used and can not be changed.

When we connected to Hive Server2 with version lower than 2.2.0, we got the following error:
```
org.apache.kyuubi.shade.org.apache.thrift.TApplicationException:
Required field 'client_protocol' is unset!
Struct:TOpenSessionReq(client_protocol:null, configuration:{kyuubi.client.version=1.7.3, set:hiveconf:hive.server2.thrift.resultset.default.fetch.size=1000, kyuubi.client.ipAddress=172.16.19.113, use:database=default})
```

In this PR, we introduced a session conf `clientProtocolVersion`.
By adding `clientProtocolVersion=8` to jdbc url, the error got fixed.

Changes of `kyuubi_jdbc.rst`

<img width="867" alt="image" src="https://github.com/apache/kyuubi/assets/88070094/8f98edf9-15c4-4d1b-9299-83b24136352b">

### _How was this patch tested?_
- [ ] Add some test cases that check the changes thoroughly including negative and positive cases if possible

- [x] Manual tests against Hive Server2 version 2.1.1-cdh6.3.0

- [x] [Run test](https://kyuubi.readthedocs.io/en/master/contributing/code/testing.html#running-tests) locally before make a pull request

### _Was this patch authored or co-authored using generative AI tooling?_
No.

Closes #5480 from zhouyifan279/protocol-version.

Closes #5480

0ee7b1f68 [zhouyifan279] Support setting kyuubi hive jdbc client protocol version
61b8038d3 [zhouyifan279] Support setting kyuubi hive jdbc client protocol version
ed4c29f2b [Cheng Pan] Update docs/deployment/migration-guide.md
dc16a05fc [zhouyifan279] Support setting kyuubi hive jdbc client protocol version
1a6bfd88c [zhouyifan279] Support setting kyuubi hive jdbc client protocol version
cb00edc37 [zhouyifan279] Support setting kyuubi hive jdbc client protocol version
c99fc4802 [zhouyifan279] Support setting kyuubi hive jdbc client protocol version

Lead-authored-by: zhouyifan279 <zhouyifan279@gmail.com>
Co-authored-by: Cheng Pan <pan3793@gmail.com>
Signed-off-by: Cheng Pan <chengpan@apache.org>
2023-10-30 23:51:54 +08:00
..
_static/css [KYUUBI #2764] [DOCS] Fix tables in docs being coverd by right toc sidebar 2022-05-27 17:21:42 +08:00
appendix [KYUUBI #4655] [DOCS] Enrich docs for Kyuubi Hive JDBC driver 2023-04-03 18:51:27 +08:00
client [KYUUBI #5480] Support setting kyuubi hive jdbc client protocol version 2023-10-30 23:51:54 +08:00
community [KYUUBI #5273] Update release docs 2023-09-12 10:49:59 +08:00
configuration [KYUUBI #5423] Support chaining SessionConfAdvisors 2023-10-30 09:48:25 +08:00
connector [KYUUBI #4614] [DOCS] Rename Flink Table Store to Apache Paimon (Incubating) in docs Connectors for Flink SQL Query Engine 2023-03-27 13:04:42 +08:00
contributing [KYUUBI #5500] Add Kyuubi Code Program to Doc 2023-10-23 17:39:37 +08:00
deployment [KYUUBI #5423] Support chaining SessionConfAdvisors 2023-10-30 09:48:25 +08:00
extensions [KYUUBI #5118][DOC] Add Flink KDF doc 2023-09-07 14:49:57 +08:00
imgs [KYUUBI #4371] Fix typo in kyuubi_ecosystem.drawio 2023-02-20 13:00:45 +08:00
monitor [KYUUBI #5365] Don't use Log4j2's extended throwable conversion pattern in default logging configurations 2023-10-11 21:41:22 +08:00
overview [KYUUBI #4624] [Docs] Fix table headers in kyuubi_vs_hive.md 2023-03-28 16:40:35 +08:00
quick_start [KYUUBI #5523] [DOC] Update the Kyuubi supported components version 2023-10-25 22:12:08 +08:00
security [KYUUBI #5427] [AUTHZ] Shade spark authz plugin 2023-10-20 20:10:34 +08:00
tools [KYUUBI #4994][REST] Support listing all engines 2023-09-23 23:18:32 +08:00
conf.py [KYUUBI #4768] [INFRA] Guidelines for Document and Code contributions 2023-04-27 19:58:10 +08:00
index.rst [KYUUBI #5154] [Doc] Move configuration docs to the top level 2023-08-11 18:23:08 +08:00
make.bat [KYUUBI #4235] [DOCS] Prefer https:// URLs in docs 2023-02-03 14:01:11 +08:00
Makefile [KYUUBI #874] [ASF] ASF Publish 2021-08-16 11:48:21 +08:00
requirements.txt [KYUUBI #4768] [INFRA] Guidelines for Document and Code contributions 2023-04-27 19:58:10 +08:00