diff --git a/develop/dev-guide-choose-driver-or-orm.md b/develop/dev-guide-choose-driver-or-orm.md index 5e72e2d4065a..06f91490270a 100644 --- a/develop/dev-guide-choose-driver-or-orm.md +++ b/develop/dev-guide-choose-driver-or-orm.md @@ -34,11 +34,11 @@ TiDB 与 MySQL 有差异: 支持等级:**Full** -按照 [MySQL 文档](https://dev.mysql.com/doc/connector-j/5.1/en/)中的说明下载并配置 Java JDBC 驱动程序即可使用。 +按照 [MySQL 文档](https://dev.mysql.com/doc/connector-j/8.0/en/)中的说明下载并配置 Java JDBC 驱动程序即可使用。对于 TiDB v6.3.0 及以上版本,建议使用 MySQL Connector/J 8.0.29 及以上版本。 -> **注意:** +> **建议:** > -> 强烈建议使用 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 版本。 +> 因为当前 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* 标签) 有关一个完整的实例应用程序,可参阅使用 [TiDB 和 JDBC 构建一个 Java 应用](/develop/dev-guide-sample-application-java.md#第-2-步获取代码)。 @@ -49,6 +49,8 @@ TiDB 与 MySQL 有差异: [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 认证插件等功能。 +基于 SM3 的认证仅在 TiDB 版本的 MySQL Connector/J 中支持。 + 如果你使用的是 **Maven**,请将以下内容添加到你的 ``: ```xml