From bb38aca755e2c40b2ef38159c6338ee736390ba2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dani=C3=ABl=20van=20Eeden?= Date: Tue, 19 Dec 2023 13:56:38 +0100 Subject: [PATCH 1/4] Add info about compatibility issues with Connector/J 8.0 with TiDB v7.5.0 --- develop/dev-guide-choose-driver-or-orm.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/develop/dev-guide-choose-driver-or-orm.md b/develop/dev-guide-choose-driver-or-orm.md index b8b4d585a4cea..92372c0fd367e 100644 --- a/develop/dev-guide-choose-driver-or-orm.md +++ b/develop/dev-guide-choose-driver-or-orm.md @@ -33,6 +33,10 @@ You can follow the [MySQL documentation](https://dev.mysql.com/doc/connector-j/e > > There is a [bug](https://bugs.mysql.com/bug.php?id=106252) in the Connector/J 8.0 versions before 8.0.32, which might cause threads to hang when using TiDB versions earlier than v6.3.0. To avoid this issue, it is recommended that you use either MySQL Connector/J 8.0.32 or a later version, or the TiDB JDBC (see the *TiDB-JDBC* tab). +> **Note:** +> +> When using MySQL Connector/J 8.0 with TiDB v7.5.0 it is recommended to set [`server-version`](/tidb-configuration-file.md#server-version) in the configuration file for TiDB to "5.7.25-TiDB-v7.5.0" as MySQL Connector/J tries to use the `information_schema.KEYWORDS` table if the server announces a MySQL version that is 8.0.11 or newer and this table isn't present in TiDB v7.5.0. This is not needed with TiDB v7.6.0 and newer as that version comes with an `information_schema.KEYWORDS` table. This is also not needed with TiDB v7.4.0 and earlier as those versions identify themselves as MySQL 5.7. + For an example of how to build a complete application, see [Build a simple CRUD app with TiDB and JDBC](/develop/dev-guide-sample-application-java-jdbc.md). From 2e085dce0b6be3be07e567dbe0a92ecbef6b97ab Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dani=C3=ABl=20van=20Eeden?= Date: Wed, 20 Dec 2023 07:35:16 +0100 Subject: [PATCH 2/4] Update develop/dev-guide-choose-driver-or-orm.md Co-authored-by: Aolin --- develop/dev-guide-choose-driver-or-orm.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/develop/dev-guide-choose-driver-or-orm.md b/develop/dev-guide-choose-driver-or-orm.md index 92372c0fd367e..b7a20294933db 100644 --- a/develop/dev-guide-choose-driver-or-orm.md +++ b/develop/dev-guide-choose-driver-or-orm.md @@ -31,11 +31,8 @@ You can follow the [MySQL documentation](https://dev.mysql.com/doc/connector-j/e > **Tip:** > -> There is a [bug](https://bugs.mysql.com/bug.php?id=106252) in the Connector/J 8.0 versions before 8.0.32, which might cause threads to hang when using TiDB versions earlier than v6.3.0. To avoid this issue, it is recommended that you use either MySQL Connector/J 8.0.32 or a later version, or the TiDB JDBC (see the *TiDB-JDBC* tab). - -> **Note:** -> -> When using MySQL Connector/J 8.0 with TiDB v7.5.0 it is recommended to set [`server-version`](/tidb-configuration-file.md#server-version) in the configuration file for TiDB to "5.7.25-TiDB-v7.5.0" as MySQL Connector/J tries to use the `information_schema.KEYWORDS` table if the server announces a MySQL version that is 8.0.11 or newer and this table isn't present in TiDB v7.5.0. This is not needed with TiDB v7.6.0 and newer as that version comes with an `information_schema.KEYWORDS` table. This is also not needed with TiDB v7.4.0 and earlier as those versions identify themselves as MySQL 5.7. +> - There is a [bug](https://bugs.mysql.com/bug.php?id=106252) in the Connector/J 8.0 versions before 8.0.32, which might cause threads to hang when using TiDB versions earlier than v6.3.0. To avoid this issue, it is recommended that you use either MySQL Connector/J 8.0.32 or a later version, or the TiDB JDBC (see the *TiDB-JDBC* tab). +> - When using MySQL Connector/J 8.0 with TiDB v7.5.0, it is recommended to set the TiDB configuration item [`server-version`](/tidb-configuration-file.md#server-version) to `"5.7.25-TiDB-v7.5.0"`. MySQL Connector/J attempts to access the `information_schema.KEYWORDS` table if the TiDB server reports a version of MySQL 8.0.11 or later. However, this table is not present in TiDB v7.5.0. For an example of how to build a complete application, see [Build a simple CRUD app with TiDB and JDBC](/develop/dev-guide-sample-application-java-jdbc.md). From 6654bcf8c7c6fa3f62a4fcc11ca274b740e7a0fa Mon Sep 17 00:00:00 2001 From: Aolin Date: Wed, 20 Dec 2023 15:30:04 +0800 Subject: [PATCH 3/4] make ci happy Signed-off-by: Aolin --- develop/dev-guide-choose-driver-or-orm.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/develop/dev-guide-choose-driver-or-orm.md b/develop/dev-guide-choose-driver-or-orm.md index b7a20294933db..ad29759222fbb 100644 --- a/develop/dev-guide-choose-driver-or-orm.md +++ b/develop/dev-guide-choose-driver-or-orm.md @@ -29,10 +29,10 @@ Support level: **Full** You can follow the [MySQL documentation](https://dev.mysql.com/doc/connector-j/en/) to download and configure a Java JDBC driver. It is recommended to use MySQL Connector/J 8.0.33 or later with TiDB v6.3.0 and newer. -> **Tip:** +> **Note:** > > - There is a [bug](https://bugs.mysql.com/bug.php?id=106252) in the Connector/J 8.0 versions before 8.0.32, which might cause threads to hang when using TiDB versions earlier than v6.3.0. To avoid this issue, it is recommended that you use either MySQL Connector/J 8.0.32 or a later version, or the TiDB JDBC (see the *TiDB-JDBC* tab). -> - When using MySQL Connector/J 8.0 with TiDB v7.5.0, it is recommended to set the TiDB configuration item [`server-version`](/tidb-configuration-file.md#server-version) to `"5.7.25-TiDB-v7.5.0"`. MySQL Connector/J attempts to access the `information_schema.KEYWORDS` table if the TiDB server reports a version of MySQL 8.0.11 or later. However, this table is not present in TiDB v7.5.0. +> - When using MySQL Connector/J 8.0 with TiDB v7.5.0, it is recommended to set the TiDB configuration item [`server-version`](https://docs.pingcap.com/tidb/v7.5/tidb-configuration-file#server-version) to `"5.7.25-TiDB-v7.5.0"`. MySQL Connector/J attempts to access the `information_schema.KEYWORDS` table if the TiDB server reports a version of MySQL 8.0.11 or later. However, this table is not present in TiDB v7.5.0. For an example of how to build a complete application, see [Build a simple CRUD app with TiDB and JDBC](/develop/dev-guide-sample-application-java-jdbc.md). From af656ef8c3c48addf17acd63554a5321cc599228 Mon Sep 17 00:00:00 2001 From: Aolin Date: Wed, 20 Dec 2023 16:03:30 +0800 Subject: [PATCH 4/4] refine wording Co-authored-by: Grace Cai --- develop/dev-guide-choose-driver-or-orm.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/develop/dev-guide-choose-driver-or-orm.md b/develop/dev-guide-choose-driver-or-orm.md index ad29759222fbb..f898bc0adbb15 100644 --- a/develop/dev-guide-choose-driver-or-orm.md +++ b/develop/dev-guide-choose-driver-or-orm.md @@ -32,7 +32,7 @@ You can follow the [MySQL documentation](https://dev.mysql.com/doc/connector-j/e > **Note:** > > - There is a [bug](https://bugs.mysql.com/bug.php?id=106252) in the Connector/J 8.0 versions before 8.0.32, which might cause threads to hang when using TiDB versions earlier than v6.3.0. To avoid this issue, it is recommended that you use either MySQL Connector/J 8.0.32 or a later version, or the TiDB JDBC (see the *TiDB-JDBC* tab). -> - When using MySQL Connector/J 8.0 with TiDB v7.5.0, it is recommended to set the TiDB configuration item [`server-version`](https://docs.pingcap.com/tidb/v7.5/tidb-configuration-file#server-version) to `"5.7.25-TiDB-v7.5.0"`. MySQL Connector/J attempts to access the `information_schema.KEYWORDS` table if the TiDB server reports a version of MySQL 8.0.11 or later. However, this table is not present in TiDB v7.5.0. +> - When you are using MySQL Connector/J 8.0 with TiDB v7.5.0, it is recommended to set the TiDB configuration item [`server-version`](https://docs.pingcap.com/tidb/v7.5/tidb-configuration-file#server-version) to `"5.7.25-TiDB-v7.5.0"`. MySQL Connector/J attempts to access the `information_schema.KEYWORDS` table if the TiDB server reports a version of MySQL 8.0.11 or later. However, this table is not present in TiDB v7.5.0. For an example of how to build a complete application, see [Build a simple CRUD app with TiDB and JDBC](/develop/dev-guide-sample-application-java-jdbc.md).