Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

faq/upgrade: update upgrade faq #1527

Merged
merged 11 commits into from
Jul 10, 2019
6 changes: 6 additions & 0 deletions dev/faq/upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -203,3 +203,9 @@ TiDB 在 v2.1.1 及之前版本中,如果 charset 是 UTF8,没有对 4-byte
# Disabled.
set @@session.tidb_check_mb4_value_in_utf8 = 0;
```

- v2.1.7 及之后版本,如果对表和 column 的字符集没有严格要求为 UTF8,也不想修改客户端代码去跳过 UTF8 检查或者手动修改 column 的 charset,可以在配置文件中把 `treat-old-version-utf8-as-utf8mb4` 打开。该配置的作用是自动把 v2.1.7 版本之前创建的旧版本的表和 column 的 UTF8 字符集转成 UTF8MB4。这个转换是在 TiDB load schema 时在内存中将 UTF8 转成 UTF8MB4,不会对实际存储的数据做任何修改。在配置文件中关闭 `treat-old-version-utf8-as-utf8mb4` 并重启 TiDB 后,以前字符集为 UTF8 的表和 column 的字符集仍然还是 UTF8。

> **注意:**
>
> `treat-old-version-utf8-as-utf8mb4` 参数默认打开,如果客户端强制需要用 UTF8 而不用 UTF8MB4,需要在配置文件中关闭。
9 changes: 8 additions & 1 deletion v2.1-legacy/op-guide/upgrade-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -202,4 +202,11 @@ TiDB 在 v2.1.1 及之前版本中,如果 charset 是 UTF8,没有对 4-byte

# Disabled.
set @@session.tidb_check_mb4_value_in_utf8 = 0;
```
```

- v2.1.7 及之后版本,如果对表和 column 的字符集没有严格要求为 UTF8,也不想修改客户端代码去跳过 UTF8 检查或者手动修改 column 的 charset,可以在配置文件中把 `treat-old-version-utf8-as-utf8mb4` 打开。该配置的作用是自动把 v2.1.7 版本之前创建的旧版本的表和 column 的 UTF8 字符集转成 UTF8MB4。这个转换是在 TiDB load schema 时在内存中将 UTF8 转成 UTF8MB4,不会对实际存储的数据做任何修改。在配置文件中关闭 `treat-old-version-utf8-as-utf8mb4` 并重启 TiDB 后,以前字符集为 UTF8 的表和 column 的字符集仍然还是 UTF8。

> **注意:**
>
> `treat-old-version-utf8-as-utf8mb4` 参数默认打开,如果客户端强制需要用 UTF8 而不用 UTF8MB4,需要在配置文件中关闭。

6 changes: 6 additions & 0 deletions v2.1/faq/upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -203,3 +203,9 @@ TiDB 在 v2.1.1 及之前版本中,如果 charset 是 UTF8,没有对 4-byte
# Disabled.
set @@session.tidb_check_mb4_value_in_utf8 = 0;
```

- v2.1.7 及之后版本,如果对表和 column 的字符集没有严格要求为 UTF8,也不想修改客户端代码去跳过 UTF8 检查或者手动修改 column 的 charset,可以在配置文件中把 `treat-old-version-utf8-as-utf8mb4` 打开。该配置的作用是自动把 v2.1.7 版本之前创建的旧版本的表和 column 的 UTF8 字符集转成 UTF8MB4。这个转换是在 TiDB load schema 时在内存中将 UTF8 转成 UTF8MB4,不会对实际存储的数据做任何修改。在配置文件中关闭 `treat-old-version-utf8-as-utf8mb4` 并重启 TiDB 后,以前字符集为 UTF8 的表和 column 的字符集仍然还是 UTF8。

> **注意:**
>
> `treat-old-version-utf8-as-utf8mb4` 参数默认打开,如果客户端强制需要用 UTF8 而不用 UTF8MB4,需要在配置文件中关闭。
7 changes: 7 additions & 0 deletions v3.0/faq/upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -204,3 +204,10 @@ TiDB 在 v2.1.1 及之前版本中,如果 charset 是 UTF8,没有对 4-byte
# Disabled.
set @@session.tidb_check_mb4_value_in_utf8 = 0;
```

- v2.1.7 及之后版本,如果对表和 column 的字符集没有严格要求为 UTF8,也不想修改客户端代码去跳过 UTF8 检查或者手动修改 column 的 charset,可以在配置文件中把 `treat-old-version-utf8-as-utf8mb4` 打开。该配置的作用是自动把 v2.1.7 版本之前创建的旧版本的表和 column 的 UTF8 字符集转成 UTF8MB4。这个转换是在 TiDB load schema 时在内存中将 UTF8 转成 UTF8MB4,不会对实际存储的数据做任何修改。在配置文件中关闭 `treat-old-version-utf8-as-utf8mb4` 并重启 TiDB 后,以前字符集为 UTF8 的表和 column 的字符集仍然还是 UTF8。

> **注意:**
>
> `treat-old-version-utf8-as-utf8mb4` 参数默认打开,如果客户端强制需要用 UTF8 而不用 UTF8MB4,需要在配置文件中关闭。