Skip to content

Commit

Permalink
add warning for system variable tidb_skip_utf8_check (#9385) (#9406)
Browse files Browse the repository at this point in the history
  • Loading branch information
ti-chi-bot committed Jun 29, 2022
1 parent 41037d9 commit e84eb5e
Show file tree
Hide file tree
Showing 3 changed files with 9 additions and 1 deletion.
2 changes: 1 addition & 1 deletion best-practices/haproxy-best-practices.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ You can easily use HAProxy to configure and set up a load-balanced database envi
{{< copyable "shell-regular" >}}

```bash
echo 'export PATH=/app/haproxy/bin:$PATH' >> /etc/profile
echo 'export PATH=/app/haproxy:$PATH' >> /etc/profile
```

5. Check whether the installation is successful:
Expand Down
4 changes: 4 additions & 0 deletions character-set-and-collation.md
Original file line number Diff line number Diff line change
Expand Up @@ -375,6 +375,10 @@ If the specified character set is `utf8` or `utf8mb4`, TiDB only supports the va

To disable this error reporting, use `set @@tidb_skip_utf8_check=1;` to skip the character check.

> **Note:**
>
> If the character check is skipped, TiDB might fail to detect illegal UTF-8 characters written by the application, cause decoding errors when `ANALYZE` is executed, and introduce other unknown encoding issues. If your application cannot guarantee the validity of the written string, it is not recommended to skip the character check.
## Collation support framework

The syntax support and semantic support for the collation are influenced by the [`new_collations_enabled_on_first_bootstrap`](/tidb-configuration-file.md#new_collations_enabled_on_first_bootstrap) configuration item. The syntax support and semantic support are different. The former indicates that TiDB can parse and set collations. The latter indicates that TiDB can correctly use collations when comparing strings.
Expand Down
4 changes: 4 additions & 0 deletions system-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -1999,6 +1999,10 @@ Query OK, 0 rows affected, 1 warning (0.00 sec)
- This variable is used to set whether to skip UTF-8 validation.
- Validating UTF-8 characters affects the performance. When you are sure that the input characters are valid UTF-8 characters, you can set the variable value to `ON`.

> **Note:**
>
> If the character check is skipped, TiDB might fail to detect illegal UTF-8 characters written by the application, cause decoding errors when `ANALYZE` is executed, and introduce other unknown encoding issues. If your application cannot guarantee the validity of the written string, it is not recommended to skip the character check.
### tidb_slow_log_threshold

- Scope: GLOBAL
Expand Down

0 comments on commit e84eb5e

Please sign in to comment.