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

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

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

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

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 использует при повторном подключении после разрыва соединения.

При настройке клиентских программ также необходимо учитывать среду, в которой они выполняются. См. Раздел 12.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. Это происходит потому, что сервер не может выполнить запрос клиента на кодовую страницу и возвращается к значениям по умолчанию.

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

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

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

В рамках установленного соединения клиент может запросить изменение кодовой страницы и правила сортировки соединения с помощью 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;