From 4732b91187d431cfaffa9739d53ae6bc2d816610 Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Fri, 17 Jul 2020 14:03:22 +0800 Subject: [PATCH 1/2] cherry pick #3969 to release-4.0 Signed-off-by: ti-srebot --- connectors-and-apis.md | 4 ++++ security-compatibility-with-mysql.md | 1 + tidb-specific-system-variables.md | 2 +- user-account-management.md | 4 ++++ 4 files changed, 10 insertions(+), 1 deletion(-) diff --git a/connectors-and-apis.md b/connectors-and-apis.md index b277f7390fd2..00f8d4eb3203 100644 --- a/connectors-and-apis.md +++ b/connectors-and-apis.md @@ -23,6 +23,10 @@ TiDB 兼容 MySQL(5.6、5.7) 的所有连接器和 API，包括： + [MySQL Eiffel Wrapper](https://dev.mysql.com/doc/refman/5.7/en/apis-eiffel.html) + [Mysql Go API](https://github.com/go-sql-driver/mysql) +> **注意：** +> +> 若要使用 MySQL 8.0 的连接器连接到 TiDB，你必须显式地指定 `default-auth=mysql_native_password`，因为 `mysql_native_password` 不再是[默认的插件](https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password)。 + ## 使用 MySQL 连接器连接 TiDB Oracle 官方提供了以下 API，TiDB 可以兼容所有这些 API。 diff --git a/security-compatibility-with-mysql.md b/security-compatibility-with-mysql.md index 101d1fbe0ab3..e029c8b138e8 100644 --- a/security-compatibility-with-mysql.md +++ b/security-compatibility-with-mysql.md @@ -8,6 +8,7 @@ aliases: ['/docs-cn/stable/reference/security/compatibility/'] 除以下功能外，TiDB 支持与 MySQL 5.7 类似的安全特性。 - 仅支持 `mysql_native_password` 密码验证或证书验证登陆方案。 + - MySQL 8.0 中，`mysql_native_password` 不再是[默认/推荐的插件](https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password)。若要使用 MySQL 8.0 的连接器连接到 TiDB，你必须显式地指定 `default-auth=mysql_native_password`。 - 不支持外部身份验证方式（如 LDAP）。 - 不支持列级别权限设置。 - 不支持密码过期，最后一次密码变更记录以及密码生存期。[#9709](https://github.com/pingcap/tidb/issues/9709) diff --git a/tidb-specific-system-variables.md b/tidb-specific-system-variables.md index 80ec2b98ee55..79624214e058 100644 --- a/tidb-specific-system-variables.md +++ b/tidb-specific-system-variables.md @@ -362,7 +362,7 @@ mysql> desc select count(distinct a) from test.t; 这个变量用来给 TiDB 的 `backoff` 最大时间增加权重，即内部遇到网络或其他组件（TiKV、PD）故障等时，发送重试请求的最大重试时间。可以通过这个变量来调整最大重试时间，最小值为 1。 -例如，TiDB 向 PD 取 TSO 的基础超时时间是 15 秒，当 `tidb_backoff_weight = 2` 时，取 TSO 的最大超时时间为：基础时间 * 2 等于 30 秒。 +例如，TiDB 向 PD 取 TSO 的基础超时时间是 15 秒，当 `tidb_backoff_weight = 2` 时，取 TSO 的最大超时时间为：基础时间 \* 2 等于 30 秒。 在网络环境较差的情况下，适当增大该变量值可以有效缓解因为超时而向应用端报错的情况；而如果应用端希望更快地接到报错信息，则应该尽量减小该变量的值。 diff --git a/user-account-management.md b/user-account-management.md index 7c3c454296c8..8d09d77ad704 100644 --- a/user-account-management.md +++ b/user-account-management.md @@ -27,6 +27,10 @@ mysql --port 4000 --user xxx --password mysql -P 4000 -u xxx -p ``` +> **Note:** +> +> 若要使用 MySQL 8.0 的连接器连接到 TiDB，你必须显式地指定 `default-auth=mysql_native_password`，因为 `mysql_native_password` 不再是[默认的插件](https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password)。 + ## 添加用户 添加用户有两种方式： From c477f3791c247579434af8ff786a2d26d81936fa Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Fri, 17 Jul 2020 15:27:04 +0800 Subject: [PATCH 2/2] Update user-account-management.md --- user-account-management.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user-account-management.md b/user-account-management.md index 8d09d77ad704..f1e5aba58ad4 100644 --- a/user-account-management.md +++ b/user-account-management.md @@ -27,7 +27,7 @@ mysql --port 4000 --user xxx --password mysql -P 4000 -u xxx -p ``` -> **Note:** +> **注意：** > > 若要使用 MySQL 8.0 的连接器连接到 TiDB，你必须显式地指定 `default-auth=mysql_native_password`，因为 `mysql_native_password` 不再是[默认的插件](https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password)。