# JDBC版本说明
DWS JDBC驱动会持续迭代更新，修复已知问题并新增功能特性。当您需要升级JDBC驱动版本、排查连接兼容性问题或了解某版本支持的功能特性时，可查阅本版本变更记录。建议升级前仔细阅读对应版本的变更描述和备注信息。
表1JDBC版本变更记录 
| 版本           | 变更描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 备注                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| 8.1.1.100  | - 驱动默认上报操作系统用户，可指定**"connectionExtraInfo=false"**关闭。    - 修复漏洞 **jackson**升级。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 关闭上报操作系统用户字符串： ``` jdbc:postgresql://host:port/database?connectionExtraInfo=false ```                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 8.1.1.300   | 修复漏洞。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 8.1.3    | - 支持**nvarchar2**类型。  - 支持通过**resultSet.getObject** 获取**nvarchar2**对象。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 升级至开源版本**42.2.23** 。**JDBC 8.1.3** 版本之后，需使用**JDK1.8**。                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 8.1.3.100 | - 支持通过**resultSet.getNString** 获取**nvarchar2**对象。   - 修复漏洞 依赖包**fastjson** 升级到**1.2.83**。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 8.2.0      | - 兼容**Oracle Raw**数据类型。  - 修复BUG： **g** **etColumnDisplaySize()**方法获取字段长度错误问题。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 兼容**Oracle Raw** 数据类型使用方式如下： - 插入或修改。 ``` byte[] bytes = oracleResultSet.getBytes(2) prepareStatement.setBytes(bytes) //或者 prepareStatement.setObject(bytes) ```   - 查询。 ``` resultSet.getBytes() resultSet.getObject() ```                                                                                               |
| 8.2.1       | 修复BUG： 1. 使用**reWriteBatchedInserts**批量插入报错问题。  2. **spark** 入库到**dws** 报错**invalid input syntax for type oid: "03032VLM"**问题。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 8.2.1.1  | 新增参数**defaultQueryMetaData** ，默认查询SQL元信息开关，默认为**false**。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | - 因JDBC支持raw类型，需要查询metadata，因此如需使用JDBC操作raw类型，需设置**defaultQueryMetaData** 为**true**。  - 开启该参数后，**prepareStatement** 将不兼容语法**create table as** 。可以用**Statement**代替。                                                                                                                                                  |
| 8.2.1.300 | - 修复BUG： 对NVARCHAR数组类型兼容性问题。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 8.3.0     | 修复BUG： **"loadBalanceHosts=false"**不生效问题。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 8.3.0.201 | - 修复BUG： 一次执行多个函数执行无法自动拆分问题。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 8.3.0.202    | - 增加**tcpKeepAlive**配置功能，由于不同操作系统JDK存在差异，部分平台可能不支持该参数，如：windows、redhat、suse。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 当**"tcpKeepAlive=true"**时以下参数生效： 1. **TCP_KEEPIDLE=30** **（默认值）**：连接空闲30秒后开始检测。  2. **TCP_KEEPCOUNT=9（默认值）**：总共检测9次。  3. **TCP_KEEPINTERVAL=30（默认值）**：每次检测间隔30s。   |
| 8.3.1.200  | - JDBC负载均衡支持CN存活列表自动感知。 - 新增参数**cnListRefreshSwitch** ，是否开启自动感知CN存活列表，默认为**off**。  - 新增参数**cnListRefreshDelay** ，配置开启自动感知CN存活列表的延迟时间，默认为**1800000** ，单位毫秒，**"cnListRefreshSwitch=on"**时生效。  - 新增参数**cnListRefreshPeriod** ，配置自动感知CN存活列表的时间周期，默认为**1800000** ，单位毫秒，**"cnListRefreshSwitch=on"**时生效。    - JDBC支持证书吊销。 新增参数**sslCrl**吊销证书的路径，默认为空。   - JDBC支持数据库连接重连。 - 新增参数**autoReconnect** ，是否开启数据库连接自动重连，默认为**false**。  - 新增参数**reConnectCount** ，自动重连次数，默认为**10** 。当**"autoReconnect=true"**时，该参数生效，超过配置的连接次数，重连失败。     | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 8.5.0       | - 优化函数执行的语法识别。  - 优化连接串中参数发生改变后的识别。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 8.5.0.1    | 支持参数化配置开启事务。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 8.5.0.100  | - 支持IAM登录，适配ELB，增加Region终端节点。  - 优化高并发场景下创建连接的速度。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 8.5.0.101 | 修复缓存错误连接串格式问题。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 8.5.1.200  | 优化查询表和字段元数据SQL。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 8.6.1    | 增加javaArrayTypeToOid映射。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
#### 相关文档
- JDBC功能支持问题：[功能支持问题](https://support.huaweicloud.com/trouble-dws/dws_09_0205.html)
- JDBC支持的接口：[JDBC接口参考](https://support.huaweicloud.com/devg-dws/dws_04_0102.html)