Skip to content

Commit ecf8a7d

Browse files
Auto-sync: Update Chinese docs from English PR
Synced from: pingcap/docs#22839 Target PR: #21611 AI Provider: azure Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent b6270f4 commit ecf8a7d

13 files changed

Lines changed: 28 additions & 29 deletions

character-set-and-collation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -443,7 +443,7 @@ SELECT _utf8mb4'string' COLLATE utf8mb4_general_ci;
443443

444444
## 字符合法性检查
445445

446-
当指定的字符集为 utf8 或 utf8mb4 时,TiDB 仅支持合法的 utf8 字符。对于不合法的字符,会报错:`incorrect utf8 value`。该字符合法性检查与 MySQL 8.0 兼容,与 MySQL 5.7 及以下版本不兼容。
446+
当指定的字符集为 utf8 或 utf8mb4 时,TiDB 仅支持合法的 utf8 字符。对于不合法的字符,会报错:`incorrect utf8 value`。该字符合法性检查与 MySQL 8.x 兼容,与 MySQL 5.7 及以下版本不兼容。
447447

448448
如果不希望报错,可以通过 `set @@tidb_skip_utf8_check=1;` 跳过字符检查。
449449

develop/dev-guide-mysql-tools.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,21 +27,21 @@ sudo yum install mysql
2727
mysql --host <tidb_server_host> --port 4000 -u root -p --comments
2828
```
2929

30-
macOS 上的 MySQL v9.0 客户端无法正确加载 `mysql_native_password` 插件,导致连接 TiDB 时报错 `ERROR 2059 (HY000): Authentication plugin 'mysql_native_password' cannot be loaded`。为解决该问题,建议安装并使用 MySQL v8.0 客户端来连接 TiDB 。安装命令如下:
30+
macOS 上的 MySQL 9.x 客户端无法正确加载 `mysql_native_password` 插件,导致连接 TiDB 时报错 `ERROR 2059 (HY000): Authentication plugin 'mysql_native_password' cannot be loaded`。为解决该问题,建议安装并使用 MySQL 8.0 客户端来连接 TiDB 。安装命令如下:
3131

3232
```shell
3333
brew install mysql-client@8.0
3434
brew unlink mysql
3535
brew link mysql-client@8.0
3636
```
3737

38-
如果仍然遇到问题,可以尝试指定 MySQL v8.0 客户端的安装路径来使用 MySQL v8.0 客户端连接 TiDB。连接命令如下:
38+
如果仍然遇到问题,可以尝试指定 MySQL 8.0 客户端的安装路径来使用 MySQL 8.0 客户端连接 TiDB。连接命令如下:
3939

4040
```shell
4141
/opt/homebrew/opt/mysql-client@8.0/bin/mysql --comments --host ${YOUR_IP_ADDRESS} --port ${YOUR_PORT_NUMBER} -u ${your_user_name} -p
4242
```
4343

44-
请使用实际部署的 MySQL v8.0 客户端的安装路径替代上述命令中的 `/opt/homebrew/opt/mysql-client@8.0/bin/mysql`
44+
请使用实际部署的 MySQL 8.0 客户端的安装路径替代上述命令中的 `/opt/homebrew/opt/mysql-client@8.0/bin/mysql`
4545

4646
</div>
4747

dm/dm-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ aliases: ['/docs-cn/tidb-data-migration/dev/overview/','/docs-cn/tools/dm/overvi
1414

1515
## 产品特性
1616

17-
- **与 TiDB 同样保持 MySQL 兼容性。**高度兼容 MySQL 协议、MySQL 5.7 和 MySQL 8.0 的常用功能及语法。
17+
- **与 TiDB 同样保持 MySQL 兼容性。**高度兼容 MySQL 协议、MySQL 5.7 和 MySQL 8.x 的常用功能及语法。
1818
- **支持 DML & DDL 事件同步。**支持解析和同步 binlog 中的 DML 和 DDL 事件。
1919
- **支持合库合表同步模式。**可以方便的将上游各个分片 MySQL 实例的各个分表数据,合并同步到下游 TiDB 的一张表。支持自定义编写同步规则以方便各种可能的同步需求,且具备自动识别和处理上游分片 MySQL 的 DDL 变更,大幅简化运维成本。
2020
- **内置多种过滤器以灵活适应不同场景。**支持以预定义事件类型、正则表达式、SQL 表达式等多种方式在数据同步过程中对 MySQL binlog 事件进行过滤。
@@ -37,7 +37,7 @@ tiup install dm dmctl
3737

3838
+ 数据库版本要求
3939

40-
- MySQL 版本 5.6 ~ 8.0
40+
- MySQL 版本 5.6 ~ 8.4
4141
- MariaDB 版本 >= 10.1.2 (实验特性)
4242

4343
> **注意:**

dm/dm-precheck.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,6 @@ tiup dmctl check-task ./task.yaml
4646

4747
> **警告:**
4848
>
49-
> - 使用 DM 从 MySQL v8.0 迁移数据到 TiDB 目前为实验特性(从 DM v2.0 引入),不建议在生产环境下使用。
5049
> - 使用 DM 从 MariaDB 迁移数据到 TiDB 目前为实验特性,不建议在生产环境下使用。
5150
5251
- 上游 MySQL 表结构的兼容性

faq/tidb-faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ TiDB 使用起来很简单,可以将 TiDB 集群当成 MySQL 来用。你可
3232

3333
### 1.1.6 TiDB 和 MySQL 兼容性如何?
3434

35-
TiDB 支持绝大部分 MySQL 8.0 的语法,但目前还不支持触发器、存储过程、自定义函数等。详情参见[与 MySQL 兼容性对比](/mysql-compatibility.md)
35+
TiDB 支持绝大部分 MySQL 8.x 的语法,但目前还不支持触发器、存储过程、自定义函数等。详情参见[与 MySQL 兼容性对比](/mysql-compatibility.md)
3636

3737
### 1.1.7 TiDB 支持分布式事务吗?
3838

functions-and-operators/aggregate-group-by-functions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -193,4 +193,4 @@ group by id, val;
193193

194194
## 相关系统变量
195195

196-
[`group_concat_max_len`](/system-variables.md#group_concat_max_len) 变量设置 `GROUP_CONCAT()` 函数缓冲区的最大长度
196+
[`group_concat_max_len`](/system-variables.md#group_concat_max_len) 变量设置 `GROUP_CONCAT()` 函数的最大项目数

functions-and-operators/bit-functions-and-operators.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -300,11 +300,11 @@ SELECT n,1024>>n,LPAD(CONV(1024>>n,10,2),11,0) FROM cte;
300300

301301
## MySQL 兼容性
302302

303-
在处理位函数和操作符时,MySQL 8.0 与之前版本的 MySQL 之间存在一些差异。TiDB 旨在遵循 MySQL 8.0 的行为。
303+
在处理位函数和操作符时,MySQL 8.0 与以下版本的 MySQL 之间存在一些差异。TiDB 旨在遵循 MySQL 8.x 的行为。
304304

305305
## 已知问题
306306

307-
在以下情况中,TiDB 中的查询结果与 MySQL 5.7 相同,但与 MySQL 8.0 不同。
307+
在以下情况中,TiDB 中的查询结果与 MySQL 5.7 相同,但与 MySQL 8.x 不同。
308308

309309
- 二进制参数的位操作。更多信息,请参考 [#30637](https://github.com/pingcap/tidb/issues/30637)
310310
- `BIT_COUNT()` 函数的结果。更多信息,请参考 [#44621](https://github.com/pingcap/tidb/issues/44621)

mysql-compatibility.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ aliases: ['/docs-cn/dev/mysql-compatibility/','/docs-cn/dev/reference/mysql-comp
66

77
# 与 MySQL 兼容性对比
88

9-
TiDB 高度兼容 MySQL 协议,以及 MySQL 5.7 和 MySQL 8.0 常用的功能及语法。MySQL 生态中的系统工具(PHPMyAdmin、Navicat、MySQL Workbench、DBeaver 和[其他工具](/develop/dev-guide-third-party-support.md#gui))、客户端等均适用于 TiDB。
9+
TiDB 高度兼容 MySQL 协议,以及 MySQL 8.x 常用的功能及语法。MySQL 生态中的系统工具(PHPMyAdmin、Navicat、MySQL Workbench、DBeaver 和[其他工具](/develop/dev-guide-third-party-support.md#gui))、客户端等均适用于 TiDB。
1010

1111
但 TiDB 尚未支持一些 MySQL 功能,可能的原因如下:
1212

@@ -185,22 +185,22 @@ TiDB 支持大部分 [SQL 模式](/sql-mode.md)。不支持的 SQL 模式如下
185185

186186
### 默认设置
187187

188-
TiDB 的默认设置与 MySQL 5.7 和 MySQL 8.0 有以下区别:
188+
TiDB 的默认设置与 MySQL 5.7 和 MySQL 8.x 有以下区别:
189189

190190
- 字符集:
191191
+ TiDB 默认:`utf8mb4`
192192
+ MySQL 5.7 默认:`latin1`
193-
+ MySQL 8.0 默认:`utf8mb4`
193+
+ MySQL 8.x 默认:`utf8mb4`
194194

195195
- 排序规则:
196196
+ TiDB 中 `utf8mb4` 字符集默认:`utf8mb4_bin`
197197
+ MySQL 5.7 中 `utf8mb4` 字符集默认:`utf8mb4_general_ci`
198-
+ MySQL 8.0`utf8mb4` 字符集默认:`utf8mb4_0900_ai_ci`
198+
+ MySQL 8.x`utf8mb4` 字符集默认:`utf8mb4_0900_ai_ci`
199199

200200
- SQL mode:
201201
+ TiDB 默认:`ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION`
202202
+ MySQL 5.7 默认与 TiDB 相同。
203-
+ MySQL 8.0 默认 `ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION`
203+
+ MySQL 8.x 默认 `ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION`
204204

205205
- `lower_case_table_names`
206206
+ TiDB 默认:`2`,且仅支持设置该值为 `2`
@@ -212,7 +212,7 @@ TiDB 的默认设置与 MySQL 5.7 和 MySQL 8.0 有以下区别:
212212
- `explicit_defaults_for_timestamp`
213213
+ TiDB 默认:`ON`,且仅支持设置该值为 `ON`
214214
+ MySQL 5.7 默认:`OFF`
215-
+ MySQL 8.0 默认:`ON`
215+
+ MySQL 8.x 默认:`ON`
216216

217217
### 日期时间处理的区别
218218

privilege-management.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ summary: TiDB 支持 MySQL 5.7 和 MySQL 8.0 的权限管理系统。权限相
66

77
# 权限管理
88

9-
TiDB 支持 MySQL 5.7 的权限管理系统,包括 MySQL 的语法和权限类型。同时 TiDB 还支持 MySQL 8.0 的以下特性:
9+
TiDB 支持 MySQL 5.7 的权限管理系统,包括 MySQL 的语法和权限类型。同时 TiDB 还支持 MySQL 8.x 的以下特性:
1010

1111
* 从 TiDB 3.0 开始,支持 SQL 角色。
1212
* 从 TiDB 5.1 开始,支持动态权限。

security-compatibility-with-mysql.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ summary: TiDB 支持与 MySQL 5.7 类似的安全特性,同时也支持 MySQL
66

77
# 与 MySQL 安全特性差异
88

9-
TiDB 支持与 MySQL 5.7 类似的安全特性,同时 TiDB 还支持 MySQL 8.0 的部分安全特性。TiDB 的安全特性在实现上与 MySQL 存在差异。
9+
TiDB 支持与 MySQL 5.7 类似的安全特性,同时 TiDB 还支持 MySQL 8.x 的部分安全特性。TiDB 的安全特性在实现上与 MySQL 存在差异。
1010

1111
## 不支持的安全功能特性
1212

@@ -36,36 +36,36 @@ TiDB 的密码过期策略功能与 MySQL 保持一致,但是在密码过期
3636
针对密码复杂度策略功能,TiDB 与 MySQL 的比较如下:
3737

3838
- MySQL 5.7 以 validate_password 插件的形式实现了密码复杂度策略管理功能。
39-
- MySQL 8.0 重新以 validate_password 组件的形式实现了密码复杂度策略管理功能。
39+
- MySQL 8.x 重新以 validate_password 组件的形式实现了密码复杂度策略管理功能。
4040
- TiDB 从 v6.5.0 起内置实现了密码复杂度策略管理功能。
4141

4242
因此,功能实现上存在以下差异:
4343

4444
- 密码复杂度策略功能如何启用:
4545

4646
+ MySQL 5.7 以 validate_password 插件的形式实现,需要进行插件的安装以启用密码复杂度策略管理。
47-
+ MySQL 8.0 以 validate_password 组件的形式实现,需要进行组件的安装以启用密码复杂度策略管理。
47+
+ MySQL 8.x 以 validate_password 组件的形式实现,需要进行组件的安装以启用密码复杂度策略管理。
4848
+ TiDB 内置实现了密码复杂度策略管理,支持通过系统变量 [`validate_password.enable`](/system-variables.md#validate_passwordenable-从-v650-版本开始引入) 启用密码复杂度策略管理。
4949

5050
- 密码字典功能:
5151

5252
+ MySQL 5.7 通过变量 `validate_password_dictionary_file` 指定一个文件路径,在文件中写入密码中不允许包含的单词。
53-
+ MySQL 8.0 通过变量 `validate_password.dictionary_file` 指定一个文件路径,在文件中写入密码中不允许包含的单词。
53+
+ MySQL 8.x 通过变量 `validate_password.dictionary_file` 指定一个文件路径,在文件中写入密码中不允许包含的单词。
5454
+ TiDB 通过变量 [`validate_password.dictionary`](/system-variables.md#validate_passworddictionary-从-v650-版本开始引入) 指定一个字符串,在该字符串中写入密码中不允许包含的单词。
5555

5656
### 密码连续错误限制登录策略
5757

5858
针对密码连续错误限制登录策略功能,TiDB 与 MySQL 的比较如下:
5959

6060
- MySQL 5.7 不支持密码连续错误限制登录策略管理功能。
61-
- MySQL 8.0 支持密码连续错误限制登录策略管理功能。
61+
- MySQL 8.x 支持密码连续错误限制登录策略管理功能。
6262
- TiDB 从 v6.5.0 起支持密码连续错误限制登录策略管理功能。
6363

6464
因为用户的失败尝试次数和锁定状态需要做到全局一致,而 TiDB 是分布式数据库,不能像 MySQL 在服务端的内存中记录失败尝试次数和锁定状态,所以实现机制存在以下差异:
6565

6666
- 用户未被自动锁定,失败尝试次数的计数重置场景:
6767

68-
+ MySQL 8.0
68+
+ MySQL 8.x
6969

7070
- 服务器重启时,所有用户失败尝试次数的计数都会被重置。
7171
- 执行 `FLUSH PRIVILEGES` 时,所有用户失败尝试次数的计数都会被重置。
@@ -79,7 +79,7 @@ TiDB 的密码过期策略功能与 MySQL 保持一致,但是在密码过期
7979

8080
- 账户被自动锁定后的解锁场景:
8181

82-
+ MySQL 8.0
82+
+ MySQL 8.x
8383

8484
- 服务器重启时,所有用户的自动锁定标识都会被重置。
8585
- 执行 `FLUSH PRIVILEGES` 时,所有用户的自动锁定标识都会被重置。
@@ -96,7 +96,7 @@ TiDB 的密码过期策略功能与 MySQL 保持一致,但是在密码过期
9696
针对密码重用策略功能,TiDB 与 MySQL 的比较如下:
9797

9898
- MySQL 5.7 不支持密码重用策略管理功能。
99-
- MySQL 8.0 支持密码重用策略管理功能。
99+
- MySQL 8.x 支持密码重用策略管理功能。
100100
- TiDB 从 v6.5.0 起支持密码重用策略管理功能。
101101

102102
TiDB 的密码重用策略功能与 MySQL 一致,在实现密码重用策略时都增加了系统表 `mysql.password_history`,但 TiDB 与 MySQL 在删除 `mysql.user` 系统表中不存在的用户时存在以下差异:

0 commit comments

Comments
 (0)