文档首页
MySQL 8.4 参考手册
8.4 中文镜像

MySQL 8.4 参考手册 · 中文镜像

正文为中文,英文原文默认隐藏。点击任意中文段落即可展开 / 收起对应英文原文。

打开官方英文原文 ↗

译文由机器翻译生成,仅供理解参考;有疑问请以官方英文原文为准。

中文点击中文段落可显示 / 隐藏英文原文本页译文覆盖 100%

12.3.8 字符集引入器12.3.8 Character Set Introducers

字符字符串字面量、十六进制字面量或位值字面量可以有可选的字符集引入器和 COLLATE 子句,以将其指定为使用特定字符集和排序规则的字符串:A character string literal, hexadecimal literal, or bit-value literal may have an optional character set introducer and COLLATE clause, to designate it as a string that uses a particular character set and collation:

[_charset_name] literal [COLLATE collation_name]

_charset_name 表达式正式称为 引导符。它告诉解析器,“后续的字符串使用字符集 charset_name。” 引导符并不会像 CONVERT() 那样将字符串转换为引导符指定的字符集。它不会改变字符串的值,尽管可能会发生填充。引导符只是一个信号。The _charset_name expression is formally called an introducer. It tells the parser, “the string that follows uses character set charset_name.” An introducer does not change the string to the introducer character set like CONVERT() would do. It does not change the string value, although padding may occur. The introducer is just a signal.

对于字符字符串字面量,介绍符和字符串之间可以有空格,但这是可选的。For character string literals, space between the introducer and the string is permitted but optional.

对于字符集字面量,引导符指示以下字符串的字符集,但不会改变解析器在字符串内执行转义处理的方式。解析器始终根据character_set_connection指定的字符集解释转义。有关更多讨论和示例,请参见第 12.3.6 节,“字符串字面量的字符集和排序规则”。For character set literals, an introducer indicates the character set for the following string, but does not change how the parser performs escape processing within the string. Escapes are always interpreted by the parser according to the character set given by character_set_connection. For additional discussion and examples, see Section 12.3.6, “Character String Literal Character Set and Collation”.

示例:Examples:

SELECT 'abc';
SELECT _latin1'abc';
SELECT _binary'abc';
SELECT _utf8mb4'abc' COLLATE utf8mb4_danish_ci;

SELECT _latin1 X'4D7953514C';
SELECT _utf8mb4 0x4D7953514C COLLATE utf8mb4_danish_ci;

SELECT _latin1 b'1000001';
SELECT _utf8mb4 0b1000001 COLLATE utf8mb4_danish_ci;

字符集引入符和 COLLATE 子句是根据标准 SQL 规范实现的。Character set introducers and the COLLATE clause are implemented according to standard SQL specifications.

字符字符串字面量可以通过使用 _binary 引入标记为二进制字符串。十六进制字面量和位值字面量默认就是二进制字符串,因此允许使用 _binary,但通常不必要。在某些情况下,_binary 可能有助于将十六进制或位字面量保留为二进制字符串,否则这些字面量会被视为数字。例如,在 MySQL 8.4 及更高版本中,位操作允许数字或二进制字符串参数,但默认将十六进制和位字面量视为数字。要明确为此类字面量指定二进制字符串上下文,请在至少一个参数上使用 _binary 引入标记:Character string literals can be designated as binary strings by using the _binary introducer. Hexadecimal literals and bit-value literals are binary strings by default, so _binary is permitted, but normally unnecessary. _binary may be useful to preserve a hexadecimal or bit literal as a binary string in contexts for which the literal is otherwise treated as a number. For example, bit operations permit numeric or binary string arguments in MySQL 8.4 and higher, but treat hexadecimal and bit literals as numbers by default. To explicitly specify binary string context for such literals, use a _binary introducer for at least one of the arguments:

mysql> SET @v1 = X'000D' | X'0BC0';
mysql> SET @v2 = _binary X'000D' | X'0BC0';
mysql> SELECT HEX(@v1), HEX(@v2);
+----------+----------+
| HEX(@v1) | HEX(@v2) |
+----------+----------+
| BCD      | 0BCD     |
+----------+----------+

显示的结果对于这两种位操作看起来相似,但没有 _binary 的结果是 BIGINT 值,而使用 _binary 的结果是二进制字符串。由于结果类型的不同,显示的值也不同:数字结果不会显示高位的 0。The displayed result appears similar for both bit operations, but the result without _binary is a BIGINT value, whereas the result with _binary is a binary string. Due to the difference in result types, the displayed values differ: High-order 0 digits are not displayed for the numeric result.

MySQL 按如下方式确定字符字符串字面值、十六进制字面值或位值字面值的字符集和排序规则:MySQL determines the character set and collation of a character string literal, hexadecimal literal, or bit-value literal in the following manner:

  • 如果同时指定了_charset_name和COLLATE collation_name,则使用字符集charset_name和排序规则collation_name。collation_name必须是charset_name允许的排序规则。If both _charset_name and COLLATE collation_name are specified, character set charset_name and collation collation_name are used. collation_name must be a permitted collation for charset_name.

  • 如果指定了_charset_name,但未指定COLLATE,则使用字符集charset_name及其默认排序规则。要查看每个字符集的默认排序规则,请使用SHOW CHARACTER SET语句或查询INFORMATION_SCHEMA CHARACTER_SETS表。If _charset_name is specified but COLLATE is not specified, character set charset_name and its default collation are used. To see the default collation for each character set, use the SHOW CHARACTER SET statement or query the INFORMATION_SCHEMA CHARACTER_SETS table.

  • 如果未指定 _charset_name,但指定了 COLLATE collation_name:If _charset_name is not specified but COLLATE collation_name is specified:

    • 对于字符字符串字面值,使用由 character_set_connection 系统变量指定的连接默认字符集和排序规则 collation_name。collation_name 必须是连接默认字符集允许的排序规则。For a character string literal, the connection default character set given by the character_set_connection system variable and collation collation_name are used. collation_name must be a permitted collation for the connection default character set.

    • 对于十六进制字面值或位值字面值,唯一允许的排序规则是 binary,因为这些类型的字面值默认是二进制字符串。For a hexadecimal literal or bit-value literal, the only permitted collation is binary because these types of literals are binary strings by default.

  • 否则(既未指定_charset_name,也未指定COLLATE collation_name):Otherwise (neither _charset_name nor COLLATE collation_name is specified):

    • 对于字符字符串字面值,使用由character_set_connection和collation_connection系统变量给出的连接默认字符集和校对规则。For a character string literal, the connection default character set and collation given by the character_set_connection and collation_connection system variables are used.

    • 对于十六进制字面值或位值字面值,字符集和校对规则是binary。For a hexadecimal literal or bit-value literal, the character set and collation are binary.

示例:Examples:

  • 非二进制字符串,使用latin1字符集和latin1_german1_ci校对规则:Nonbinary strings with latin1 character set and latin1_german1_ci collation:

    SELECT _latin1'Müller' COLLATE latin1_german1_ci;
    SELECT _latin1 X'0A0D' COLLATE latin1_german1_ci;
    SELECT _latin1 b'0110' COLLATE latin1_german1_ci;
    
  • 具有 utf8mb4 字符集及其默认排序规则(即 utf8mb4_0900_ai_ci)的非二进制字符串:Nonbinary strings with utf8mb4 character set and its default collation (that is, utf8mb4_0900_ai_ci):

    SELECT _utf8mb4'Müller';
    SELECT _utf8mb4 X'0A0D';
    SELECT _utf8mb4 b'0110';
    
  • 具有 binary 字符集及其默认排序规则(即 binary)的二进制字符串:Binary strings with binary character set and its default collation (that is, binary):

    SELECT _binary'Müller';
    SELECT X'0A0D';
    SELECT b'0110';
    

    十六进制字面量和位值字面量不需要引导符,因为它们默认就是二进制字符串。The hexadecimal literal and bit-value literal need no introducer because they are binary strings by default.

  • 具有连接默认字符集和 utf8mb4_0900_ai_ci 排序规则的非二进制字符串(如果连接字符集不是 utf8mb4 则失败):A nonbinary string with the connection default character set and utf8mb4_0900_ai_ci collation (fails if the connection character set is not utf8mb4):

    SELECT 'Müller' COLLATE utf8mb4_0900_ai_ci;
    

    这种构造(COLLATE 仅)不适用于十六进制字面值或位字面值,因为无论连接字符集如何,它们的字符集都是 binary,而 binary 与 utf8mb4_0900_ai_ci 校对规则不兼容。在没有引入者的情况下,唯一允许的 COLLATE 子句是 COLLATE binary。This construction (COLLATE only) does not work for hexadecimal literals or bit literals because their character set is binary no matter the connection character set, and binary is not compatible with the utf8mb4_0900_ai_ci collation. The only permitted COLLATE clause in the absence of an introducer is COLLATE binary.

  • 包含连接默认字符集和校对规则的字符串:A string with the connection default character set and collation:

    SELECT 'Müller';