Skip to content

Commit 4762476

Browse files
authored
develop: update description of jdbc (#11442)
Signed-off-by: Ran <[email protected]> Signed-off-by: Ran <[email protected]>
1 parent 4589beb commit 4762476

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

develop/dev-guide-choose-driver-or-orm.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -34,11 +34,11 @@ TiDB 与 MySQL 有差异:
3434

3535
支持等级:**Full**
3636

37-
按照 [MySQL 文档](https://dev.mysql.com/doc/connector-j/5.1/en/)中的说明下载并配置 Java JDBC 驱动程序即可使用。
37+
按照 [MySQL 文档](https://dev.mysql.com/doc/connector-j/8.0/en/)中的说明下载并配置 Java JDBC 驱动程序即可使用。对于 TiDB v6.3.0 及以上版本,建议使用 MySQL Connector/J 8.0.29 及以上版本
3838

39-
> **注意**
39+
> **建议**
4040
>
41-
> 强烈建议使用 JDBC 5.1 的最后一个版本 5.1.49。因为当前 8.0.29 版本有未合并的 [Bug 修复](https://bugs.mysql.com/bug.php?id=106252),在与 TiDB 共同使用时可能会导致线程卡死。在 MySQL JDBC 8.0 未合并此修复之前,建议不要升级至 8.0 版本。
41+
> 因为当前 8.0.30 版本有未合并的 [Bug 修复](https://bugs.mysql.com/bug.php?id=106252),在与 TiDB v6.3.0 以前版本共同使用时,可能会导致线程卡死。因此,对于 v6.3.0 以前的 TiDB 版本,在 MySQL Connector/J 8.0 合并此修复之前,建议不要升级至 8.0 版本。此外,你也可以使用 TiDB 版本的 MySQL Connector/J,它是一个 fork 版本,修复了此 Bug。(详情见 *TiDB-JDBC* 标签)
4242
4343
有关一个完整的实例应用程序,可参阅使用 [TiDB 和 JDBC 构建一个 Java 应用](/develop/dev-guide-sample-application-java.md#第-2-步获取代码)
4444

@@ -49,6 +49,8 @@ TiDB 与 MySQL 有差异:
4949

5050
[TiDB-JDBC](https://github.com/pingcap/mysql-connector-j) 是基于 MySQL 8.0.29 的定制版本。TiDB-JDBC 基于 MySQL 官方 8.0.29 版本编译,修复了原 JDBC 在 prepare 模式下多参数、多字段 EOF 的错误,并新增 TiCDC snapshot 自动维护和 SM3 认证插件等功能。
5151

52+
基于 SM3 的认证仅在 TiDB 版本的 MySQL Connector/J 中支持。
53+
5254
如果你使用的是 **Maven**,请将以下内容添加到你的 `<dependencies></dependencies>`
5355

5456
```xml

0 commit comments

Comments
 (0)