10bet网址
MySQL 8.0参考手册
相关的文档10bet官方网站 本手册下载 本手册节选

10.4连接字符集和排序规则

一个连接是客户端程序连接到服务器时开始与服务器交互的会话时所生成的内容。客户端通过会话连接发送SQL语句,例如查询。服务器通过连接将响应(如结果集或错误消息)发送回客户机。

连接字符集和排序系统变量

一些字符集和排序系统变量与客户机与服务器的交互有关。其中一些已经在前面的章节中提到过:

在处理客户机和服务器之间的连接时,还涉及到其他字符集和排序系统变量。每个客户机都有特定于会话的与连接相关的字符集和排序系统变量。这些会话系统变量值在连接时初始化,但是可以在会话中更改。

关于字符集和客户端连接排序处理的几个问题可以用系统变量来回答:

要查看应用于当前会话的字符集和排序系统变量的值,使用以下语句:

SELECT * FROM performance_schema。WHERE VARIABLE_NAME IN ('character_set_client', 'character_set_connection', 'character_set_results', 'collation_connection')

下面的简单语句也显示连接变量,但也包括其他相关变量。它们可能是有用的所有字符集和整理系统变量:

显示像'character\_set\_%'这样的会话变量;显示类似“collation\_%”的会话变量;

客户端可以微调这些变量的设置,或者依赖于默认值(在这种情况下,您可以跳过本节的其余部分)。如果不使用默认值,则必须更改字符设置对于到服务器的每个连接。

不允许的客户端字符集

character_set_client系统变量不能设置为某些字符集:

Ucs2 utf16 utf16le utf32

试图使用这些字符集中的任何一个作为客户端字符集都会产生一个错误:

SET character_set_client = 'ucs2';错误1231(42000):变量'character_set_client'不能设置为'ucs2'值

如果在以下上下文中使用这些字符集中的任何一个,都将导致尝试设置,则会发生相同的错误character_set_client命名字符集:

客户端程序连接字符集配置

当客户机连接到服务器时,它指示它希望使用哪个字符集与服务器通信。(实际上,客户端指示该字符集的默认排序规则,服务器可以从中确定字符集。)服务器使用此信息设置character_set_clientcharacter_set_resultscharacter_set_connection系统变量到字符集,和collation_connection到字符集默认排序规则。实际上,服务器执行的相当于组名称操作。

如果服务器不支持所请求的字符集或排序规则,它将退回到使用服务器字符集和排序规则来配置连接。有关此回退行为的更多详细信息,请参见连接字符集错误处理

mysqlmysqladminmysqlcheckmysqlimport,mysqlshow客户端程序确定使用的默认字符集如下所示:

  • 在没有其他信息的情况下,每个客户机通常使用编译后的默认字符集utf8mb4

  • 的值等操作系统设置的基础上,每个客户机可以自动检测要使用的字符集LC_ALLUnix系统上的locale环境变量或Windows系统上的代码页设置。对于可以从操作系统获得区域设置的系统,客户端使用它来设置默认字符集,而不是使用编译后的默认字符集。例如,设置ru_RU。KOI8-R导致koi8r要使用的字符集。因此,用户可以在其环境中配置本地语言环境,以供MySQL客户机使用。

    如果没有精确的匹配,操作系统字符集将映射到最接近的MySQL字符集。如果客户端不支持匹配的字符集,则使用编译后的默认值。例如,use utf8而且utf - 8映射到utf8mb4,ucs2不支持作为连接字符集,因此它映射到编译后的默认值。

    C应用程序可以通过调用使用基于操作系统设置的字符集自动检测mysql_options ()连接服务器前请执行以下操作:

    mysql_options (mysql MYSQL_SET_CHARSET_NAME MYSQL_AUTODETECT_CHARSET_NAME);
  • 每个客户端支持——default-character-set选项,该选项允许用户显式指定字符集以覆盖客户机其他方式确定的任何默认值。

    请注意

    某些字符集不能用作客户端字符集。试图用它们——default-character-set产生一个错误。看到不允许的客户端字符集

mysql客户端,要使用与默认字符集不同的字符集,可以显式执行组名称语句(请参见客户端程序连接字符集配置).要更容易地实现相同的结果,请在选项文件中指定字符集。例如,以下选项文件设置将更改设置为的三个与连接相关的字符集系统变量koi8r每次你调用mysql

(mysql) default-character-set = koi8r

如果您正在使用mysql如果客户端启用了自动重新连接(不推荐),则最好使用字符集命令而不是组名称.例如:

mysql>字符集koi8r字符集更改

字符集命令的问题组名称语句,并更改默认字符集thatmysql在连接断开后重新连接时使用。

在配置客户机程序时,还必须考虑它们在其中执行的环境。看到第10.5节“配置应用程序字符集和排序规则”

连接字符集配置的SQL语句

建立连接后,客户端可以更改当前会话的字符集和排序系统变量。这些变量可以使用语句,但是有两个更方便的语句影响连接相关的字符集系统变量作为一个组:

请注意

某些字符集不能用作客户端字符集。试图用它们组名称设置字符集产生一个错误。看到不允许的客户端字符集

例子:假设column1被定义为CHAR(5)字符集拉丁文.如果你不说组名称设置字符集,然后SELECT columnn1 FROM t,服务器返回所有的值column1使用客户端连接时指定的字符集。另一方面,如果你说设置名称“latin1”中的一个字符集'latin1'在发出之前选择语句时,服务器将转换latin2latin1就在送回结果之前。对于不属于两个字符集的字符,转换可能是有损的。

连接字符集错误处理

试图使用不适当的连接字符集或排序规则会产生错误,或导致服务器退回到给定连接的默认字符集和排序规则。本节描述在配置连接字符集时可能出现的问题。这些问题可能发生在建立连接或更改已建立连接中的字符集时。

连接时间错误处理

有些字符集不能用作客户端字符集;看到不允许的客户端字符集.如果您指定的字符集有效但不允许作为客户端字符集,服务器将返回一个错误:

shell> mysql——default-character-set=ucs2 ERROR 1231(42000):变量'character_set_client'不能设置为'ucs2'的值

如果您指定的字符集客户端无法识别,则会产生一个错误:

错误2019 (HY000): Can't initialize Character set bogus(路径:/usr/local/mysql/share/charsets/Index.xml)

如果您指定的字符集客户机可以识别,而服务器不能识别,则服务器将退回到其默认字符集和排序规则。假设服务器配置为使用latin1而且latin1_swedish_ci作为它的默认值,它不承认gb18030作为一个有效的字符集。指定一个客户端——default-character-set = gb18030能够连接到服务器,但是生成的字符集不是客户端想要的:

显示“character\_set\_%”的会话变量+--------------------------+--------+ | Variable_name |值  | +--------------------------+--------+ | character_set_client | latin1 |中的一个| character_set_connection | latin1 |中的一个……| character_set_results | latin1 |…+--------------------------+--------+ mysql >显示会话变量如“collation_connection”;+----------------------+-------------------+ | Variable_name |值  | +----------------------+-------------------+ | collation_connection | latin1_swedish_ci  | +----------------------+-------------------+

可以看到连接系统变量已设置为反映字符集和排序规则latin1而且latin1_swedish_ci.这是因为服务器无法满足客户端字符集请求而退回到其默认值。

在这种情况下,客户端不能使用它想要的字符集,因为服务器不支持它。客户端必须愿意使用不同的字符集,或者连接到支持所需字符集的不同服务器。

同样的问题发生在更微妙的上下文中:当客户机告诉服务器使用服务器识别的字符集,但服务器端不知道该字符集在客户机端的默认排序规则时。例如,当MySQL 8.0客户端想要使用utf8mb4作为客户端字符集。指定一个客户端——default-character-set = utf8mb4能够连接到服务器。然而,就像前面的例子一样,服务器返回到它的默认字符集和排序规则,而不是客户端请求的:

显示“character\_set\_%”的会话变量+--------------------------+--------+ | Variable_name |值  | +--------------------------+--------+ | character_set_client | latin1 |中的一个| character_set_connection | latin1 |中的一个……| character_set_results | latin1 |…+--------------------------+--------+ mysql >显示会话变量如“collation_connection”;+----------------------+-------------------+ | Variable_name |值  | +----------------------+-------------------+ | collation_connection | latin1_swedish_ci  | +----------------------+-------------------+

为什么会出现这种情况?毕竟,utf8mb48.0客户机和5.7服务器都知道它,因此它们都能识别它。要理解这种行为,有必要理解当客户机告诉服务器它想使用哪个字符集时,它实际上是在告诉服务器该字符集的默认排序规则。因此,上述行为的发生是由多种因素共同作用的结果:

  • 的默认排序规则utf8mb4MySQL 5.7和MySQL 8.0不同(utf8mb4_general_ci为5.7,utf8mb4_0900_ai_ci为8.0)。

  • 当8.0客户端请求的字符集utf8mb4,它发送给服务器的是默认的8.0utf8mb4排序;也就是说,utf8mb4_0900_ai_ci

  • utf8mb4_0900_ai_ci是MySQL 8.0才实现的,所以5.7服务器不识别它。

  • 因为5.7服务器不识别utf8mb4_0900_ai_ci,它不能满足客户端字符集请求,并退回到其默认字符集和排序规则(latin1而且latin1_swedish_ci).

在这种情况下,客户端仍然可以使用utf8mb4通过发出一个设置名称“utf8mb4”连接后声明。生成的排序规则是5.7默认的utf8mb4排序;也就是说,utf8mb4_general_ci.的排序utf8mb4_0900_ai_ci,它无法实现这一点,因为服务器不识别该排序规则。客户必须愿意使用不同的utf8mb4或从MySQL 8.0或更高版本连接到服务器。

运行时错误处理

在已建立的连接中,客户端可以请求更改连接字符集和排序规则组名称设置字符集

有些字符集不能用作客户端字符集;看到不允许的客户端字符集.如果您指定的字符集有效但不允许作为客户端字符集,服务器将返回一个错误:

mysql>设置名称为ucs2;错误1231(42000):变量'character_set_client'不能设置为'ucs2'值

如果服务器不识别字符集(或排序规则),它会产生一个错误:

mysql> SET NAMES 'bogus';错误1115(42000):未知字符集:'bogus' mysql> set NAMES 'utf8mb4' COLLATE 'bogus';错误1273 (HY000):未知排序:'bogus'
提示

客户端想要验证其请求的字符集是否被服务器接受,在连接并检查结果是否为预期的字符集后,可以执行以下语句:

选择@@character_set_client;