Несколько системных переменных набора символов и правил сопоставления связаны с взаимодействием клиента с сервером. Некоторые из них были упомянуты в предыдущих разделах:

Дополнительные системные переменные набора символов и правил сопоставления участвуют в обработке трафика для соединения между клиентом и сервером. Каждый клиент имеет свои системные переменные набора символов и правил сопоставления, специфичные для сеанса. Значения этих переменных сеанса инициализируются во время подключения, но могут быть изменены в рамках сеанса.

Некоторые вопросы о обработке наборов символов и правил сопоставления для подключений клиентов можно ответить в терминах системных переменных:

Чтобы увидеть значения системных переменных набора символов и правил сопоставления, применяемых к текущему сеансу, используйте эту инструкцию:

SELECT * FROM performance_schema.session_variables
WHERE VARIABLE_NAME IN (
'character_set_client', 'character_set_connection',
'character_set_results', 'collation_connection'
) ORDER BY VARIABLE_NAME;

Следующие более простые инструкции также отображают переменные подключения, но включают и другие связанные переменные. Они могут быть полезны для просмотра всех системных переменных набора символов и правил сопоставления:

SHOW SESSION VARIABLES LIKE 'character\_set\_%';
SHOW SESSION VARIABLES LIKE 'collation\_%';

Клиенты могут настроить параметры этих переменных или полагаться на значения по умолчанию (в этом случае вы можете пропустить остальную часть этого раздела). Если вы не используете значения по умолчанию, вы должны изменить параметры набора символов для каждого подключения к серверу.

Переменная character_set_client не может быть установлена на определенные наборы символов:

ucs2
utf16
utf16le
utf32

Попытка использовать любой из этих наборов символов в качестве набора символов клиента приводит к ошибке:

mysql> SET character_set_client = 'ucs2';
ERROR 1231 (42000): Variable 'character_set_client'
can't be set to the value of 'ucs2'

Такая же ошибка возникает, если любой из этих наборов символов используется в следующих контекстах, все из которых приводят к попытке установить character_set_client на указанный набор символов:

При подключении клиента к серверу он указывает кодировку, которую он хочет использовать для связи с сервером. (Фактически, клиент указывает значение по умолчанию для этой кодировки, по которому сервер может определить кодировку.) Сервер использует эту информацию для установки системных переменных character_set_client, character_set_results, character_set_connection на кодировку и collation_connection на значение по умолчанию для этой кодировки. По сути, сервер выполняет операцию, эквивалентную SET NAMES.

Если сервер не поддерживает запрошенную кодировку или сортировку, он использует кодировку и сортировку сервера для настройки соединения. Более подробную информацию об этом поведении обратного хода вы найдёте в разделе Обработка ошибок кодировки соединения.

Клиентские программы mysql, mysqladmin, mysqlcheck, mysqlimport и mysqlshow определяют кодировку по умолчанию следующим образом:

В случае с клиентом mysql, чтобы использовать кодировку, отличную от кодировки по умолчанию, вы можете явно выполнить оператор SET NAMES каждый раз при подключении к серверу (см. Настройка кодировки соединения клиентской программы). Чтобы достичь того же результата проще, укажите кодировку в вашем файле параметров. Например, следующее значение в файле параметров изменяет три системных переменных кодировки, связанных с подключением, на koi8r каждый раз при вызове mysql:

[mysql]
default-character-set=koi8r

Если вы используете клиент mysql с включенной автоматической повторной установкой (что не рекомендуется), предпочтительнее использовать команду charset, а не SET NAMES. Например:

mysql> charset koi8r
Charset changed

Команда charset выполняет оператор SET NAMES и также изменяет кодировку по умолчанию, которую mysql использует при повторном подключении после разрыва соединения.

При настройке клиентских программ также необходимо учитывать среду, в которой они выполняются. См. Раздел 10.5, «Настройка кодировки и сортировки приложения».

После установления соединения клиенты могут изменить переменные кодировки символов и правил сортировки для текущей сессии. Эти переменные можно изменить индивидуально, используя запросы SET, но существуют два более удобных запроса, влияющих на переменные кодировки, связанные с соединением, как группу:

Пример: Предположим, что column1 определён как CHAR(5) CHARACTER SET latin2. Если вы не укажете SET NAMES или SET CHARACTER SET, то для SELECT column1 FROM t сервер отправит все значения для column1, используя кодировку, указанную клиентом при подключении. С другой стороны, если вы укажете SET NAMES 'latin1' или SET CHARACTER SET 'latin1' перед выполнением запроса SELECT, сервер преобразует значения latin2 в latin1 непосредственно перед отправкой результатов. Преобразование может быть неполным для символов, которых нет в обеих кодировках.

Попытки использовать неподходящую кодировку соединения или сортировку могут привести к ошибке или заставить сервер перейти к своей кодировке и сортировке по умолчанию для данного соединения. В этом разделе описаны проблемы, которые могут возникнуть при настройке кодировки соединения. Эти проблемы могут возникнуть при установлении соединения или при изменении кодировки в рамках существующего соединения.

Обработка ошибок при подключении

Некоторые кодировки не могут быть использованы в качестве кодировки клиента; см. Недопустимые кодировки клиента. Если вы укажете кодировку, которая допустима, но не разрешена в качестве кодировки клиента, сервер вернёт ошибку:

$> mysql --default-character-set=ucs2
ERROR 1231 (42000): Variable 'character_set_client' can't be set to
the value of 'ucs2'

Если вы укажете кодировку, которую клиент не распознаёт, это вызовет ошибку:

$> mysql --default-character-set=bogus
mysql: Character set 'bogus' is not a compiled character set and is
not specified in the '/usr/local/mysql/share/charsets/Index.xml' file
ERROR 2019 (HY000): Can't initialize character set bogus
(path: /usr/local/mysql/share/charsets/)

Если вы укажете кодировку, которую клиент распознаёт, но сервер нет, сервер переходит к своей кодировке и сортировке по умолчанию. Предположим, что сервер настроен на использование latin1 и latin1_swedish_ci в качестве значений по умолчанию, и он не распознаёт gb18030 в качестве допустимой кодировки. Клиент, который указывает --default-character-set=gb18030, может подключиться к серверу, но результат — не та кодировка, которую хочет клиент:

mysql> SHOW SESSION VARIABLES LIKE 'character\_set\_%';
+--------------------------+--------+
| Variable_name            | Value  |
+--------------------------+--------+
| character_set_client     | latin1 |
| character_set_connection | latin1 |
...
| character_set_results    | latin1 |
...
+--------------------------+--------+
mysql> SHOW SESSION VARIABLES LIKE 'collation_connection';
+----------------------+-------------------+
| Variable_name        | Value             |
+----------------------+-------------------+
| collation_connection | latin1_swedish_ci |
+----------------------+-------------------+

Вы можете увидеть, что переменные системы соединения были установлены для отражения кодировки и сортировки latin1 и latin1_swedish_ci. Это происходит потому, что сервер не может удовлетворить запрос клиента на кодировку и переходит к значениям по умолчанию.

В этом случае клиент не может использовать желаемую кодировку, поскольку сервер её не поддерживает. Клиент должен либо принять другую кодировку, либо подключиться к другому серверу, поддерживающему нужную кодировку.

Такая же проблема возникает в более тонком контексте: когда клиент сообщает серверу использовать кодировку, которую сервер распознаёт, но сортировка по умолчанию для этой кодировки на стороне клиента неизвестна на стороне сервера. Например, это происходит, когда клиент MySQL 8.0 хочет подключиться к серверу MySQL 5.7, используя utf8mb4 в качестве кодировки клиента. Клиент, который указывает --default-character-set=utf8mb4, может подключиться к серверу. Однако, как и в предыдущем примере, сервер переходит к своей кодировке и сортировке по умолчанию, а не к той, которую запросил клиент:

mysql> SHOW SESSION VARIABLES LIKE 'character\_set\_%';
+--------------------------+--------+
| Variable_name            | Value  |
+--------------------------+--------+
| character_set_client     | latin1 |
| character_set_connection | latin1 |
...
| character_set_results    | latin1 |
...
+--------------------------+--------+
mysql> SHOW SESSION VARIABLES LIKE 'collation_connection';
+----------------------+-------------------+
| Variable_name        | Value             |
+----------------------+-------------------+
| collation_connection | latin1_swedish_ci |
+----------------------+-------------------+

Почему это происходит? Ведь utf8mb4 известна как клиенту 8.0, так и серверу 5.7, поэтому оба её распознают. Чтобы понять это поведение, необходимо понять, что когда клиент сообщает серверу, какую кодировку он хочет использовать, он фактически сообщает серверу сортировку по умолчанию для этой кодировки. Таким образом, указанное поведение обусловлено совокупностью факторов:

В этом случае клиент по-прежнему может использовать utf8mb4, выполнив оператор SET NAMES 'utf8mb4' после подключения. Результатом будет сортировка по умолчанию 5.7 — utf8mb4; то есть utf8mb4_general_ci. Если клиент также хочет сортировку utf8mb4_0900_ai_ci, он не сможет этого достичь, поскольку сервер не распознаёт эту сортировку. Клиент должен либо принять другую сортировку utf8mb4, либо подключиться к серверу MySQL 8.0 или выше.

Обработка ошибок во время выполнения

В рамках установленного соединения клиент может запросить изменение кодировки и сортировки соединения с помощью SET NAMES или SET CHARACTER SET.

Некоторые кодировки не могут быть использованы в качестве кодировки клиента; см. Недопустимые кодировки клиента. Если вы укажете кодировку, которая допустима, но не разрешена в качестве кодировки клиента, сервер вернёт ошибку:

mysql> SET NAMES 'ucs2';
ERROR 1231 (42000): Variable 'character_set_client' can't be set to
the value of 'ucs2'

Если сервер не распознаёт кодировку (или сортировку), он выдаст ошибку:

mysql> SET NAMES 'bogus';
ERROR 1115 (42000): Unknown character set: 'bogus'

mysql> SET NAMES 'utf8mb4' COLLATE 'bogus';
ERROR 1273 (HY000): Unknown collation: 'bogus'

SELECT @@character_set_client;