activate_all_roles_on_login

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

Предоставленные роли включают те, которые явно предоставлены пользователю, и те, которые указаны в значении системной переменной mandatory_roles.

activate_all_roles_on_login применяется только при входе, а также в начале выполнения хранимых процедур и представлений, выполняемых в контексте создателя. Для изменения активных ролей в сеансе используйте SET ROLE. Для изменения активных ролей для хранимой процедуры тело процедуры должно выполнить SET ROLE.

admin_address

IP-адрес, на котором нужно прослушивать TCP/IP-соединения на интерфейсе административной сети (см. Раздел 7.1.12.1, «Интерфейсы подключения»). Значение по умолчанию для admin_address отсутствует. Если эта переменная не указана при запуске, сервер не поддерживает административный интерфейс. Сервер также имеет системную переменную bind_address для настройки обычных (неадминистративных) клиентских TCP/IP-соединений. См. Раздел 7.1.12.1, «Интерфейсы подключения».

Если admin_address указан, его значение должно соответствовать этим требованиям:

IP-адрес можно указать как IPv4- или IPv6-адрес. Если значение является именем хоста, сервер разрешает имя в IP-адрес и связывается с этим адресом. Если имя хоста разрешается на несколько IP-адресов, сервер использует первый IPv4-адрес, если таковой есть, или первый IPv6-адрес в противном случае.

Сервер обрабатывает разные типы адресов следующим образом:

Эти правила применяются к указанию пространства имен сети для адреса:

Дополнительную информацию о пространствах имен сети см. в Разделе 7.1.14, «Поддержка пространств имен сети».

Если привязка к адресу завершается ошибкой, сервер выводит сообщение об ошибке и не запускается.

Системная переменная admin_address аналогична системной переменной bind_address, которая связывает сервер с адресом для обычных клиентских соединений, но с этими отличиями:

admin_port

Номер порта TCP/IP для подключений на административном сетевом интерфейсе (см. Раздел 7.1.12.1, «Интерфейсы подключения»). Установка этой переменной в 0 приводит к использованию значения по умолчанию.

Установка admin_port не имеет эффекта, если admin_address не указан, так как в этом случае сервер не поддерживает административный сетевой интерфейс.

admin_ssl_ca

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

admin_ssl_capath

Системная переменная admin_ssl_capath подобна переменной ssl_capath, за исключением того, что она применяется к интерфейсу административного подключения, а не к основному интерфейсу подключения. Сведения о настройке поддержки шифрования для административного интерфейса см. в разделе Поддержка шифрованных подключений административного интерфейса.

admin_ssl_cert

Системная переменная admin_ssl_cert подобна переменной ssl_cert, за исключением того, что она применяется к интерфейсу административного подключения, а не к основному интерфейсу подключения. Сведения о настройке поддержки шифрования для административного интерфейса см. в разделе Поддержка шифрованных подключений административного интерфейса.

admin_ssl_cipher

Системная переменная admin_ssl_cipher подобна переменной ssl_cipher, за исключением того, что она применяется к интерфейсу административного подключения, а не к основному интерфейсу подключения. Сведения о настройке поддержки шифрования для административного интерфейса см. в разделе Поддержка шифрованных подключений административного интерфейса.

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

Попытка включить в список шифров значения, не указанные здесь, при настройке этой переменной приводит к ошибке ().

admin_ssl_crl

Системная переменная admin_ssl_crl подобна переменной ssl_crl, за исключением того, что она применяется к интерфейсу административного подключения, а не к основному интерфейсу подключения. Сведения о настройке поддержки шифрования для административного интерфейса см. в разделе Поддержка шифрованных подключений административного интерфейса.

admin_tls_ciphersuites

Системная переменная admin_tls_ciphersuites похожа на tls_ciphersuites, за исключением того, что она применяется к интерфейсу административного подключения, а не к основному интерфейсу подключения. Сведения о настройке поддержки шифрования для административного интерфейса см. в Поддержке шифрованных подключений административного интерфейса.

Значение представляет собой список нуля или более имён шифров, разделённых двоеточием, из тех, что перечислены здесь:

Попытка включить в список шифров значения, которые здесь не показаны, при настройке этой переменной вызывает ошибку ().

admin_tls_version

Системная переменная admin_tls_version похожа на tls_version, за исключением того, что она применяется к интерфейсу административного подключения, а не к основному интерфейсу подключения. Сведения о настройке поддержки шифрования для административного интерфейса см. в Поддержке шифрованных подключений административного интерфейса.

authentication_openid_connect_configuration

Определяет список издателей и соответствующих открытых ключей подписи, используемых для проверки подписи токена идентификации для Раздела 8.4.1.9, «Подключаемая аутентификация OpenID Connect». Принимает строку JSON с префиксом JSON:// или полный путь к файлу JSON с префиксом file://.

authentication_policy

Эта переменная используется для администрирования возможностей многофакторной аутентификации (MFA). Для операторов CREATE USER и ALTER USER, используемых для управления определениями учетных записей MySQL, она определяет, какой(ие) фактор(ы) аутентификации могут быть указаны, где “фактор” соответствует методу или плагину аутентификации, связанному с учетной записью. authentication_policy определяет следующие аспекты многофакторной аутентификации:

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

Значение authentication_policy представляет собой список из 1, 2 или 3 элементов, разделенных запятыми, каждый из которых соответствует фактору аутентификации и имеет одну из перечисленных здесь форм со своими значениями:

В каждом случае элемент может быть окружен пробелами. Весь список должен быть заключен в одинарные кавычки.

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

Значение по умолчанию для authentication_policy — '*,,'. Это означает, что фактор 1 является обязательным в определениях учетных записей и может использовать любой плагин аутентификации (с caching_sha2_password по умолчанию), а факторы 2 и 3 являются необязательными и каждый может использовать любой плагин аутентификации.

Если authentication_policy не указывает плагин по умолчанию для первого фактора, плагином по умолчанию для этого фактора является caching_sha2_password, хотя может использоваться и другой плагин.

В следующей таблице показаны некоторые возможные значения для authentication_policy и политика, которую каждый из них устанавливает для создания или изменения учетных записей.

authentication_windows_log_level

Эта переменная доступна только в том случае, если включен плагин аутентификации Windows authentication_windows и включен код отладки. См. Раздел 8.4.1.5, «Плагинная аутентификация Windows».

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

authentication_windows_use_principal_name

Эта переменная доступна только в случае, если плагин Windows-аутентификации authentication_windows включён. См. Раздел 8.4.1.5, «Windows Pluggable Authentication».

Клиент, который выполняет аутентификацию с помощью функции InitSecurityContext(), должен предоставить строку, идентифицирующую сервис, к которому он подключается (targetName). MySQL использует имя принципа (UPN) учётной записи, под которой работает сервер. UPN имеет вид user_id@computer_name и не требует регистрации для использования. Это UPN отправляется сервером в начале процесса рукопожатия аутентификации.

Эта переменная управляет отправкой сервером UPN в начальном запросе. По умолчанию переменная включена. По соображениям безопасности она может быть отключена, чтобы избежать отправки имени учётной записи сервера клиенту в открытом виде. Если переменная отключена, сервер всегда отправляет байт 0x00 в первом запросе, клиент не указывает targetName, и в результате используется аутентификация NTLM.

Если сервер не может получить своё UPN (что происходит в основном в средах, не поддерживающих аутентификацию Kerberos), UPN не отправляется сервером, и используется аутентификация NTLM.

autocommit

Режим автоматического подтверждения. Если значение равно 1, все изменения в таблице вступают в силу немедленно. Если значение равно 0, необходимо использовать COMMIT для подтверждения транзакции или ROLLBACK для её отмены. Если autocommit равно 0 и вы измените его на 1, MySQL выполнит автоматическое COMMIT любой открытой транзакции. Другой способ начать транзакцию — использование START TRANSACTION или BEGIN оператора. См. Раздел 15.3.1, «START TRANSACTION, COMMIT, and ROLLBACK Statements».

По умолчанию подключения клиентов начинаются с autocommit равным 1. Чтобы клиенты начинали с значения по умолчанию 0, установите глобальное значение autocommit при запуске сервера с параметром --autocommit=0. Чтобы установить переменную с помощью файла настроек, добавьте эти строки:

[mysqld]
autocommit=0

automatic_sp_privileges

Когда значение этой переменной равно 1 (по умолчанию), сервер автоматически предоставляет привилегии EXECUTE и ALTER ROUTINE создателю хранимой процедуры, если пользователь ещё не имеет права на выполнение и изменение/удаление процедуры. (Привилегия ALTER ROUTINE требуется для удаления процедуры.) Сервер также автоматически лишает создателя этих привилегий при удалении процедуры. Если automatic_sp_privileges равно 0, сервер не добавляет и не удаляет эти привилегии автоматически.

Создателем процедуры является учётная запись, используемая для выполнения оператора CREATE для неё. Это может отличаться от учётной записи, указанной как DEFINER в определении процедуры.

Если вы запускаете mysqld с --skip-new, automatic_sp_privileges устанавливается в OFF.

Действие этой переменной одинаково в отношении JavaScript-библиотек и хранимых процедур; когда automatic_sp_privileges равно 1, привилегии EXECUTE и ALTER ROUTINE автоматически предоставляются создателю библиотеки, если у создателя этих привилегий ещё нет.

См. также Раздел 27.2.2, «Хранимые процедуры и привилегии MySQL».

auto_generate_certs

Эта переменная управляет автоматическим созданием файлов ключей и сертификатов SSL в каталоге данных, если они ещё не существуют.

При запуске сервер автоматически генерирует файлы сертификатов и ключей SSL для серверной и клиентской сторон в каталоге данных, если переменная системы auto_generate_certs включена и файлы SSL для сервера отсутствуют в каталоге данных. Эти сертификаты всегда генерируются в таких случаях, независимо от значений других TLS-параметров. Эти сертификаты и ключи позволяют устанавливать безопасные клиентские соединения с использованием SSL; см. Раздел 8.3.1, «Настройка MySQL для использования зашифрованных соединений».

Дополнительную информацию об автоматическом создании файлов SSL, включая имена и характеристики файлов, см. в Разделе 8.3.3.1, «Создание сертификатов и ключей SSL и RSA с помощью MySQL»

Переменные sha256_password_auto_generate_rsa_keys и caching_sha2_password_auto_generate_rsa_keys взаимосвязаны, но управляют автоматическим созданием пар ключей RSA, необходимых для безопасного обмена паролями с использованием RSA по незашифрованным соединениям.

back_log

Количество ожидающих запросов на подключение, которые может обработать MySQL. Это значение становится важным, когда основной поток MySQL получает очень большое количество запросов на подключение за очень короткий промежуток времени. Тогда основному потоку требуется некоторое время (хотя и очень небольшое), чтобы проверить подключение и запустить новый поток. Значение back_log указывает, сколько запросов можно накопить за это короткое время, прежде чем MySQL временно перестанет обрабатывать новые запросы. Увеличивать это значение необходимо только если ожидается большое количество подключений за короткий промежуток времени.

Другими словами, это значение представляет размер очереди для входящих TCP/IP соединений. Ваша операционная система имеет собственный предел для размера этой очереди. Более подробная информация должна быть в руководстве по системному вызову Unix listen(). Обратитесь к документации вашей ОС, чтобы узнать максимальное значение для этой переменной. back_log не может быть установлено выше предела, заданного вашей операционной системой.

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

basedir

Путь к основной директории установки MySQL.

big_tables

При включении сервер сохраняет все временные таблицы на диске вместо оперативной памяти. Это предотвращает большинство ошибок The table tbl_name is full для операций SELECT, требующих большой временной таблицы, но также замедляет запросы, для которых временные таблицы в оперативной памяти были бы достаточны.

Значение по умолчанию для новых подключений — OFF (использовать временные таблицы в памяти). Обычно необходимость в включении этой переменной не возникает. Когда временные внутренние таблицы в памяти управляются движком хранения TempTable (по умолчанию), и превышен максимальный объём памяти, который может занимать движок хранения TempTable, движок хранения TempTable начинает сохранять данные во временные файлы на диске. Когда временные таблицы в памяти управляются движком хранения MEMORY, таблицы в памяти автоматически преобразуются в таблицы на диске по мере необходимости. Дополнительная информация содержится в Разделе 10.4.4, «Использование внутренних временных таблиц в MySQL».

bind_address

Сервер MySQL прослушивает один или несколько сетевых сокетов для подключений TCP/IP. Каждый сокет привязан к одному адресу, но один адрес может быть сопоставлен с несколькими сетевыми интерфейсами. Для указания способа прослушивания сервером подключений TCP/IP, установите системную переменную bind_address при запуске сервера. Сервер также имеет системную переменную admin_address, которая позволяет устанавливать административные подключения на выделенном интерфейсе. См. Раздел 7.1.12.1, “Интерфейсы подключений”.

Если задано bind_address, оно принимает список из одного или нескольких значений адресов, каждое из которых может указывать на единственный IP-адрес или имя хоста без использования подстановочных символов. Каждый адрес может включать указатель сетевого пространства имён. Если указан только один адрес, он может использовать один из форматов адресов с подстановкой символов, которые позволяют прослушивать подключения на нескольких сетевых интерфейсах (*, 0.0.0.0 или ::). Несколько адресов разделяются запятыми. Когда указано несколько значений, каждое значение должно указывать на единственный IP-адрес (IPv4 или IPv6) или имя хоста без использования подстановочных символов, и форматы адресов с подстановкой символов (*, 0.0.0.0 или ::) запрещены.

IP-адреса могут быть указаны как IPv4 или IPv6 адреса. Для любого значения, являющегося именем хоста, сервер разрешает имя в IP-адрес и привязывается к этому адресу. Если имя хоста разрешается в несколько IP-адресов, сервер использует первый IPv4 адрес, если таковой имеется, или первый IPv6 адрес в противном случае.

Сервер обрабатывает различные типы адресов следующим образом:

Эти правила применяются к указанию сетевого пространства имён для адреса:

Дополнительную информацию о сетевых пространствах имён см. в Разделе 7.1.14, “Поддержка сетевых пространств имён”.

Если привязка к любому адресу завершается ошибкой, сервер выдаёт ошибку и не запускается.

Примеры:

Когда bind_address называет единственное значение (с подстановкой символов или без), сервер прослушивает на одном сокете, который для адреса с подстановкой символов может быть привязан к нескольким сетевым интерфейсам. Когда bind_address называет список из нескольких значений, сервер прослушивает на одном сокете на каждое значение, при этом каждый сокет привязан к одному сетевому интерфейсу. Количество сокетов прямо пропорционально количеству указанных значений. В зависимости от эффективности приема подключений операционной системой, длинные списки значений могут привести к снижению производительности при приёме TCP/IP подключений.

Поскольку для сокетов прослушивания и файлов сетевых пространств имён выделены дескрипторы файлов, может потребоваться увеличить системную переменную open_files_limit.

Если вы собираетесь привязать сервер к определённому адресу, убедитесь, что системная таблица mysql.user содержит учётную запись с административными привилегиями, которую можно использовать для подключения к этому адресу. В противном случае вы не сможете остановить сервер. Например, если вы привязываете сервер к *, вы можете подключиться к нему с использованием всех существующих учётных записей. Но если вы привязываете сервер к ::1, он принимает подключения только по этому адресу. В этом случае, сначала убедитесь, что учётная запись 'root'@'::1' присутствует в таблице mysql.user, чтобы вы могли подключиться к серверу для его остановки.

block_encryption_mode

Эта переменная управляет режимом шифрования блоков для блочных алгоритмов, таких как AES. Она влияет на шифрование для AES_ENCRYPT() и AES_DECRYPT().

block_encryption_mode принимает значение в формате aes-keylen-mode, где keylen - длина ключа в битах, а mode - режим шифрования. Значение не чувствительно к регистру. Разрешённые значения keylen - 128, 192 и 256. Разрешённые значения mode - ECB, CBC, CFB1, CFB8, CFB128 и OFB.

Например, эта команда заставляет функции шифрования AES использовать длину ключа 256 бит и режим CBC:

SET block_encryption_mode = 'aes-256-cbc';

При попытке установить block_encryption_mode на значение, содержащее недопустимую длину ключа или режим, который не поддерживается библиотекой SSL, произойдёт ошибка.

build_id

Это 160-битная SHA1 подпись, которая генерируется компоновщиком при компиляции сервера на системах Linux с -DWITH_BUILD_ID=ON (включена по умолчанию) и преобразуется в шестнадцатеричную строку. Это значение только для чтения служит уникальным идентификатором сборки и записывается в лог сервера при запуске.

build_id не поддерживается на платформах, отличных от Linux.

bulk_insert_buffer_size

MyISAM использует специальный кэш древовидной структуры, чтобы ускорить массовую вставку для INSERT ... SELECT, INSERT ... VALUES (...), (...), ... и LOAD DATA при добавлении данных в незаполненные таблицы. Эта переменная ограничивает размер дерева кэша в байтах на поток. Установка значения 0 отключает эту оптимизацию. Значение по умолчанию — 8 МБ.

Установка значения сессии этой системной переменной является ограниченной операцией. Пользователь сессии должен иметь права, достаточные для установки ограниченных переменных сессии. См. Раздел 7.1.9.1, «Привилегии системных переменных».

caching_sha2_password_digest_rounds

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

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

caching_sha2_password_auto_generate_rsa_keys

Сервер использует эту переменную, чтобы определить, следует ли автоматически генерировать файлы пар закрытых/открытых ключей RSA в каталоге данных, если их еще нет.

При запуске сервер автоматически генерирует файлы пар закрытых/открытых ключей RSA в каталоге данных, если выполняются все следующие условия: Системная переменная sha256_password_auto_generate_rsa_keys или caching_sha2_password_auto_generate_rsa_keys включена; параметры RSA не указаны; файлы RSA отсутствуют в каталоге данных. Эти файлы пар ключей обеспечивают безопасный обмен паролями с использованием RSA по незашифрованным соединениям для учетных записей, аутентифицированных с помощью плагина sha256_password (устаревший) или caching_sha2_password; см. Раздел 8.4.1.2, «SHA-256 подключаемая аутентификация» и Раздел 8.4.1.1, «Кэширование SHA-2 подключаемой аутентификации».

Для получения дополнительной информации об автоматическом создании файлов RSA, включая имена и характеристики файлов, см. Раздел 8.3.3.1, «Создание SSL и RSA сертификатов и ключей с использованием MySQL»

Системная переменная auto_generate_certs связана, но управляет автоматическим созданием файлов сертификатов и ключей SSL, необходимых для безопасных соединений с использованием SSL.

caching_sha2_password_private_key_path

Эта переменная указывает имя пути файла закрытого ключа RSA для плагина аутентификации caching_sha2_password. Если файл указан как относительный путь, он интерпретируется относительно каталога данных сервера. Файл должен быть в формате PEM.

Для получения информации о caching_sha2_password, см. Раздел 8.4.1.1, «Кэширование SHA-2 подключаемой аутентификации».

caching_sha2_password_public_key_path

Эта переменная указывает имя пути файла открытого ключа RSA для плагина аутентификации caching_sha2_password. Если файл указан как относительный путь, он интерпретируется относительно каталога данных сервера. Файл должен быть в формате PEM.

Для получения информации о caching_sha2_password, включая информацию о том, как клиенты запрашивают открытый ключ RSA, см. Раздел 8.4.1.1, «Кэширование SHA-2 подключаемой аутентификации».

character_set_client

Кодировка для запросов, поступающих от клиента. Значение этой переменной для сессии устанавливается с использованием кодировки, запрошенной клиентом при подключении к серверу. (Многие клиенты поддерживают опцию --default-character-set для явного указания кодировки. См. также Раздел 12.4, «Кодировки и сортировки соединений».) Глобальное значение переменной используется для установки значения сессии в случаях, когда запрашиваемое клиентом значение неизвестно или недоступно, или сервер настроен на игнорирование запросов клиента. Это может произойти, когда клиент запрашивает кодировку, неизвестную серверу, например, когда клиент с поддержкой японского языка запрашивает sjis при подключении к серверу, не настроенному с поддержкой sjis.

Некоторые кодировки не могут использоваться в качестве кодировки клиента. Попытка использовать их в качестве значения character_set_client приводит к ошибке. См. Недопустимые кодировки клиента.

character_set_connection

Кодировка, используемая для литералов, указанных без указателя кодировки, и для преобразования числа в строку. Для получения информации о вводных данных см. Раздел 12.3.8, «Указатели кодировки».

character_set_database

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

Установка значения сессии этой системной переменной является ограниченной операцией. Пользователь сессии должен иметь права, достаточные для установки ограниченных переменных сессии. См. Раздел 7.1.9.1, «Права на системные переменные».

Глобальные системные переменные character_set_database и collation_database устарели; ожидается, что они будут удалены в будущей версии MySQL.

Присваивание значения системным переменным сессии character_set_database и collation_database устарело, и присваивания выдают предупреждение. Ожидается, что переменные сессии станут доступными только для чтения (и присваивания им будут вызывать ошибку) в будущей версии MySQL, в которой останется возможность доступа к переменным сессии для определения кодировки и сортировки базы данных для базы данных по умолчанию.

character_set_filesystem

Кодировка файловой системы. Эта переменная используется для интерпретации строковых литералов, которые ссылаются на имена файлов, например, в операторах LOAD DATA и SELECT ... INTO OUTFILE и функции LOAD_FILE(). Такие имена файлов преобразуются из character_set_client в character_set_filesystem перед попыткой открытия файла. Значение по умолчанию — binary, что означает, что преобразование не происходит. Для систем, на которых разрешены многобайтовые имена файлов, другое значение может быть более подходящим. Например, если система представляет имена файлов с помощью UTF-8, установите character_set_filesystem в 'utf8mb4'.

Установка значения сессии этой системной переменной является ограниченной операцией. Пользователь сессии должен иметь права, достаточные для установки ограниченных переменных сессии. См. Раздел 7.1.9.1, «Права на системные переменные».

character_set_results

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

character_set_server

Кодировка сервера по умолчанию. См. Раздел 12.15, «Настройка кодировки». Если вы устанавливаете эту переменную, вы также должны установить collation_server для указания сортировки для кодировки.

character_set_system

Кодировка, используемая сервером для хранения идентификаторов. Значение всегда равно utf8mb3.

character_sets_dir

Каталог, в котором установлены наборы символов. См. Раздел 12.15, «Настройка наборов символов».

check_proxy_users

Некоторые плагины аутентификации реализуют отображение псевдопользователей для себя (например, плагины аутентификации PAM и Windows). Другие плагины аутентификации по умолчанию не поддерживают псевдопользователей. Из них некоторые могут запросить, чтобы сам сервер MySQL отображал псевдопользователей в соответствии с предоставленными привилегиями для псевдопользователей: mysql_native_password (устарело), sha256_password (устарело).

Если системная переменная check_proxy_users включена, сервер выполняет отображение псевдопользователей для любых плагинов аутентификации, которые делают такой запрос. Чтобы воспользоваться поддержкой серверного отображения псевдопользователей для плагина sha256_password, необходимо включить sha256_password_proxy_users.

Сведения об отображении пользователей см. в Разделе 8.2.19, «Псевдопользователи».

collation_connection

Сортировка набора символов соединения. collation_connection важна для сравнения строковых литералов. Для сравнения строк со значениями столбцов collation_connection не имеет значения, потому что столбцы имеют свою сортировку, которая имеет более высокую сортировочную приоритетность (см. Раздел 12.8.4, «Сортировка согласованности в выражениях»).

Использование имени настроенной сортировки для этой переменной приводит к появлению предупреждения.

collation_database

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

Глобальные системные переменные character_set_database и collation_database устарели; ожидается их удаление в будущей версии MySQL.

Назначение значения сессионным системным переменным character_set_database и collation_database устарело, и назначения приводят к появлению предупреждения. Ожидается, что сессионные переменные станут только для чтения (а назначения приведут к ошибке) в будущей версии MySQL, в которой по-прежнему возможно получить доступ к сессионным переменным для определения набора символов базы данных и сортировки для базы данных по умолчанию.

Использование имени настроенной сортировки для collation_database приводит к появлению предупреждения.

collation_server

Сортировка по умолчанию сервера. См. Раздел 12.15, «Настройка наборов символов».

Установка значения, соответствующего имени настроенной сортировки, приводит к появлению предупреждения.

completion_type

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

completion_type влияет на транзакции, которые начинаются с START TRANSACTION или BEGIN и заканчиваются COMMIT или ROLLBACK. Он не применяется к неявным фиксациям, возникающим в результате выполнения операторов, перечисленных в разделе 15.3.3, «Операторы, вызывающие неявную фиксацию». Он также не применяется к XA COMMIT, XA ROLLBACK, или когда autocommit=1.

component_scheduler.enabled

При установке в OFF при запуске фоновый поток не запускается. Задачи по-прежнему можно планировать, но они не выполняются, пока component_scheduler не будет включено. При установке в ON при запуске компонент полностью работоспособен.

Также можно задавать значение динамически, чтобы получить следующие эффекты:

concurrent_insert

Если AUTO (значение по умолчанию), MySQL разрешает операторам INSERT и SELECT выполняться одновременно для таблиц MyISAM, не имеющих свободных блоков в середине файла данных.

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

Если вы запускаете mysqld с --skip-new, concurrent_insert устанавливается в NEVER.

См. также раздел 10.11.3, «Одновременные вставки».

connect_timeout

Количество секунд, которое сервер mysqld ожидает пакет подключения перед ответом с Bad handshake. Значение по умолчанию — 10 секунд.

Увеличение значения connect_timeout может помочь, если клиенты часто сталкиваются с ошибками типа Lost connection to MySQL server at 'XXX', system error: errno.

connection_memory_chunk_size

Устанавливает размер фрагмента для обновлений счетчика глобального использования памяти Global_connection_memory. Переменная состояния обновляется только тогда, когда общее потребление памяти всеми пользовательскими соединениями изменяется более чем на эту величину. Отключите обновления, установив connection_memory_chunk_size = 0.

Расчет памяти не включает память, используемую системными пользователями, такими как пользователь root MySQL. Память, используемая буферным пулом InnoDB, также не включается.

Для установки этой переменной необходимо иметь привилегию SYSTEM_VARIABLES_ADMIN или SUPER.

connection_memory_limit

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

Предел, установленный этой переменной, не применяется к системным пользователям или к учетной записи root MySQL. Память, используемая буферным пулом InnoDB, также не включается.

Для установки этой переменной необходимо иметь привилегию SYSTEM_VARIABLES_ADMIN или SUPER.

connection_memory_status_limit

Это максимальный объем памяти, который может быть потреблен любым одним пользовательским соединением до того, как будет увеличен счетчик Count_hit_query_past_connection_memory_status_limit.

core_file

Необходимо ли записывать файл дампа памяти, если сервер неожиданно завершает работу. Эта переменная устанавливается с помощью параметра --core-file.

create_admin_listener_thread

Необходимо ли использовать выделенный поток прослушивания для клиентских соединений на административном сетевом интерфейсе (см. Раздел 7.1.12.1, «Интерфейсы соединений»). Значение по умолчанию — OFF; то есть поток управления для обычных соединений на основном интерфейсе также обрабатывает соединения для административного интерфейса.

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

Установка create_admin_listener_thread не оказывает влияния, если admin_address не указан, поскольку в этом случае сервер не поддерживает административный сетевой интерфейс.

cte_max_recursion_depth

Максимальная глубина рекурсии для выражения общего табличного выражения (CTE). Сервер прекращает выполнение любого CTE, который рекурсивно вызывает себя более чем на указанное количество уровней. Для получения дополнительной информации см. Ограничение рекурсии выражений общих таблиц.

datadir

Путь к каталогу данных сервера MySQL. Относительные пути разрешаются относительно текущего каталога. Если вы ожидаете, что сервер будет запускаться автоматически (то есть в контекстах, для которых вы не можете заранее знать текущий каталог), лучше всего указать значение datadir как абсолютный путь.

debug

Эта переменная указывает текущие настройки отладки. Она доступна только для серверов, построенных с поддержкой отладки. Начальное значение берётся из значения экземпляров опции --debug, заданной при запуске сервера. Глобальные и сеансовые значения могут быть установлены во время выполнения.

Установка сеансового значения этой системной переменной — ограниченная операция. Пользователь сеанса должен иметь достаточные привилегии для установки ограниченных сеансовых переменных. См. Раздел 7.1.9.1, «Привилегии на системные переменные».

Присвоение значения, начинающегося с + или -, приводит к добавлению или вычитанию значения из текущего значения:

mysql> SET debug = 'T';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| T       |
+---------+

mysql> SET debug = '+P';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| P:T     |
+---------+

mysql> SET debug = '-P';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| T       |
+---------+

Для получения дополнительной информации, см. Раздел 7.9.4, «Пакет DBUG».

debug_sync

Эта переменная является пользовательским интерфейсом для механизма Debug Sync. Использование Debug Sync требует, чтобы MySQL был сконфигурирован с опцией -DWITH_DEBUG=ON CMake (см. Раздел 2.8.7, «Параметры конфигурации исходного кода MySQL»); в противном случае, эта системная переменная недоступна.

Глобальное значение переменной только для чтения и указывает, включен ли механизм. По умолчанию, Debug Sync отключен, и значение debug_sync равно OFF. Если сервер запускается с --debug-sync-timeout=N, где N — значение таймаута, большее 0, Debug Sync включён, и значение debug_sync равно ON - current signal, за которым следует имя сигнала. Также N становится значением таймаута по умолчанию для отдельных точек синхронизации.

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

Установка сеансового значения этой системной переменной — ограниченная операция. Пользователь сеанса должен иметь достаточные привилегии для установки ограниченных сеансовых переменных. См. Раздел 7.1.9.1, «Привилегии на системные переменные».

Для описания механизма Debug Sync и способов использования точек синхронизации, см. Документацию MySQL Server Doxygen.

default_collation_for_utf8mb4

Эта переменная устанавливается сервером как кодировка по умолчанию для набора символов utf8mb4. Значение переменной дублируется с источника на репликатор, чтобы репликатор мог правильно обрабатывать данные, полученные с источника с другой кодировкой по умолчанию для набора символов utf8mb4. Эта переменная в первую очередь предназначена для поддержки репликации с сервера репликации MySQL 5.7 или более ранней версии на сервер репликации MySQL более поздней версии, или групповой репликации с узлом MySQL 5.7 в качестве основного и одним или несколькими вторичными узлами MySQL 8.0 или более поздних версий. Кодировка по умолчанию для набора символов utf8mb4 в MySQL 5.7 — utf8mb4_general_ci, но utf8mb4_0900_ai_ci в более поздних версиях. Переменная отсутствует в выпусках, более ранних, чем MySQL 8.0; поэтому, если репликатор не получает значения переменной, он предполагает, что источник из более ранней версии и устанавливает значение на предыдущую кодировку по умолчанию utf8mb4_general_ci.

Кодировка по умолчанию utf8mb4 используется в следующих операциях:

См. также Раздел 12.9, «Поддержка Unicode».

default_password_lifetime

Эта переменная определяет глобальную политику автоматического истечения срока действия паролей. Значение по умолчанию default_password_lifetime равно 0, что отключает автоматическое истечение срока действия паролей. Если значение default_password_lifetime — положительное целое число N, оно указывает допустимый срок действия паролей; пароли должны меняться каждые N дней.

Глобальная политика истечения срока действия паролей может быть переопределена по желанию для отдельных учётных записей с помощью опции истечения срока действия паролей в операциях CREATE USER и ALTER USER. См. Раздел 8.2.15, «Управление паролями».

default_storage_engine

Базовый движок хранения для таблиц. См. Главу 18, Альтернативные движки хранения. Эта переменная устанавливает движок хранения только для постоянных таблиц. Для установки движка хранения для TEMPORARY таблиц, установите системную переменную default_tmp_storage_engine.

Чтобы узнать, какие движки хранения доступны и включены, используйте оператор SHOW ENGINES или запросите таблицу INFORMATION_SCHEMA ENGINES.

Если вы отключите базовый движок хранения при запуске сервера, вы должны установить базовый движок как для постоянных, так и для TEMPORARY таблиц на другой движок, иначе сервер не запустится.

default_table_encryption

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

Переменная default_table_encryption применяется только к схемам и общим пространствам имен таблиц, созданным пользователем. Она не управляет шифрованием mysql системного пространства имен таблиц.

Изменение значения default_table_encryption в ходе работы требует наличия привилегий SYSTEM_VARIABLES_ADMIN и TABLE_ENCRYPTION_ADMIN, или устаревшего SUPER привилегии.

default_table_encryption поддерживает синтаксис SET PERSIST и SET PERSIST_ONLY. См. Раздел 7.1.9.3, «Постоянные системные переменные».

Для получения дополнительной информации см. Определение значения шифрования по умолчанию для схем и общих пространств имен таблиц.

default_tmp_storage_engine

Базовый движок хранения для TEMPORARY таблиц (созданных с помощью CREATE TEMPORARY TABLE). Для установки движка хранения для постоянных таблиц, установите системную переменную default_storage_engine. Также см. обсуждение этой переменной относительно возможных значений.

Если вы отключите базовый движок хранения при запуске сервера, вы должны установить базовый движок как для постоянных, так и для TEMPORARY таблиц на другой движок, иначе сервер не запустится.

default_week_format

Значение по умолчанию для использования в функции WEEK(). См. Раздел 14.7, «Функции даты и времени».

delay_key_write

Эта переменная определяет, как использовать отложенные записи ключей. Она применяется только к MyISAM таблицам. Отложенные записи ключей приводят к тому, что буферы ключей не сбрасываются между записями. См. также Раздел 18.2.1, «Параметры запуска MyISAM».

Эта переменная может принимать одно из следующих значений, чтобы повлиять на обработку DELAY_KEY_WRITE параметра таблицы, который может использоваться в CREATE TABLE операторах.

Если для таблицы включён DELAY_KEY_WRITE, буфер ключей не сбрасывается для таблицы при каждом обновлении индекса, а только при закрытии таблицы. Это значительно ускоряет записи в ключи, но если вы используете эту функцию, вы должны добавить автоматическую проверку всех MyISAM таблиц, запустив сервер с установленной системной переменной myisam_recover_options (например, myisam_recover_options='BACKUP,FORCE'). См. Раздел 7.1.8, «Системные переменные сервера» и Раздел 18.2.1, «Параметры запуска MyISAM».

Если вы запускаете mysqld с --skip-new, delay_key_write устанавливается в значение OFF.

delayed_insert_limit

Эта системная переменная устарела (поскольку DELAYED вставки не поддерживаются), и следует ожидать ее удаления в будущей версии.

delayed_insert_timeout

Эта системная переменная устарела (поскольку DELAYED вставки не поддерживаются), и следует ожидать ее удаления в будущей версии.

delayed_queue_size

Эта системная переменная устарела (поскольку DELAYED вставки не поддерживаются), и следует ожидать ее удаления в будущей версии.

disabled_storage_engines

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

[mysqld]
disabled_storage_engines="MyISAM,FEDERATED"

По умолчанию, disabled_storage_engines пуста (никакие хранилища не отключены), но ее можно установить в виде списка, разделенного запятыми, одного или нескольких хранилищ (регистр не учитывается). Любое хранилище, указанное в значении, не может использоваться для создания таблиц или табличных пространств с помощью CREATE TABLE или CREATE TABLESPACE, и не может использоваться с ALTER TABLE ... ENGINE или ALTER TABLESPACE ... ENGINE для изменения хранилища данных существующих таблиц или табличных пространств. Попытки сделать это приведут к ошибке.

disabled_storage_engines не ограничивает другие операторы DDL для существующих таблиц, такие как CREATE INDEX, TRUNCATE TABLE, ANALYZE TABLE, DROP TABLE или DROP TABLESPACE. Это позволяет плавно перейти, чтобы существующие таблицы или табличные пространства, использующие отключенное хранилище, можно было перенести на разрешенное хранилище с помощью таких средств, как ALTER TABLE ... ENGINE permitted_engine.

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

disabled_storage_engines отключена и не оказывает никакого влияния, если сервер запущен с любым из этих параметров: --initialize, --initialize-insecure, --skip-grant-tables.

disconnect_on_expired_password

Эта переменная управляет тем, как сервер обрабатывает клиентов с истекшими паролями:

Для получения дополнительной информации о взаимодействии настроек клиента и сервера, связанных с обработкой истекших паролей, см. Раздел 8.2.16, «Обработка истекших паролей сервером».

div_precision_increment

Эта переменная указывает число цифр, на которое увеличивать масштаб результата операций деления, выполняемых с оператором /. Значение по умолчанию равно 4. Минимальное и максимальное значения соответственно равны 0 и 30. Следующий пример иллюстрирует эффект увеличения значения по умолчанию.

mysql> SELECT 1/7;
+--------+
| 1/7    |
+--------+
| 0.1429 |
+--------+
mysql> SET div_precision_increment = 12;
mysql> SELECT 1/7;
+----------------+
| 1/7            |
+----------------+
| 0.142857142857 |
+----------------+

dragnet.log_error_filter_rules

Правила фильтра, которые управляют работой компонента фильтра журнала ошибок log_filter_dragnet. Если log_filter_dragnet не установлен, dragnet.log_error_filter_rules недоступен. Если log_filter_dragnet установлен, но не включен, изменения в dragnet.log_error_filter_rules не имеют эффекта.

Эффект значения по умолчанию аналогичен фильтру log_sink_internal с настройкой log_error_verbosity=2.

Статус-переменная dragnet.Status может быть использована для определения результата последнего присваивания переменной dragnet.log_error_filter_rules.

enterprise_encryption.maximum_rsa_key_size

Эта переменная ограничивает максимальный размер ключей RSA, генерируемых MySQL Enterprise Encryption. Переменная доступна только при установке компонента MySQL Enterprise Encryption component_enterprise_encryption.

Наименьшее значение — 2048 бит, что является минимальной длиной ключа RSA, приемлемой по современным рекомендациям. Значение по умолчанию — 4096 бит. Наибольшее значение — 16384 бит. Генерация более длинных ключей может потребовать значительных ресурсов ЦП, поэтому вы можете использовать эту настройку для ограничения длины ключей, обеспечивая достаточную безопасность для ваших потребностей, балансируя это с использованием ресурсов. Дополнительную информацию см. в разделе 8.6.2, «Настройка MySQL Enterprise Encryption».

enterprise_encryption.rsa_support_legacy_padding

Эта переменная управляет тем, можно ли расшифровать или проверить зашифрованные данные и подписи, созданные MySQL Enterprise Encryption с использованием старых функций библиотеки openssl_udf, компонентом MySQL Enterprise Encryption (component_enterprise_encryption). Переменная доступна только при установке компонента MySQL Enterprise Encryption.

Чтобы компоненты поддерживали расшифровку и проверку содержимого, созданного старыми функциями библиотеки openssl_udf, необходимо установить системную переменную padding в ON. При установке ON, если функции компонента не могут расшифровать или проверить содержимое, предполагая, что используется схема RSAES-OAEP или RSASSA-PSS (как используется компонентом), они предпринимают еще одну попытку, предполагая схему RSAES-PKCS1-v1_5 или RSASSA-PKCS1-v1_5 (как используется библиотекой openssl_udf). При установке OFF, если функции компонента не могут расшифровать или проверить содержимое с использованием своих обычных схем, они возвращают нулевой результат. Дополнительную информацию см. в разделе 8.6.2, «Настройка MySQL Enterprise Encryption».

end_markers_in_json

Добавлять ли концевые маркеры в вывод оптимизатора в формате JSON. См. MySQL Internals: Переменная системы end_markers_in_json.

eq_range_index_dive_limit

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

col_name IN(val1, ..., valN)
col_name = val1 OR ... OR col_name = valN

В обоих случаях выражение содержит N диапазонов равенства. Оптимизатор может производить оценки строк, используя погружение в индекс или статистику индекса. Если eq_range_index_dive_limit больше 0, оптимизатор использует существующую статистику индекса вместо погружения в индекс, если существует eq_range_index_dive_limit или более диапазонов равенства. Таким образом, чтобы разрешить использование погружения в индекс для до N диапазонов равенства, установите eq_range_index_dive_limit в N + 1. Чтобы отключить использование статистики индекса и всегда использовать погружение в индекс независимо от N, установите eq_range_index_dive_limit в 0.

Дополнительную информацию см. в разделе «Оптимизация диапазонов равенства множественных сравнений».

Чтобы обновить статистику индекса таблицы для получения лучших оценок, используйте ANALYZE TABLE.

error_count

Количество ошибок, возникших в результате последнего оператора, сгенерировавшего сообщения. Эта переменная только для чтения. См. Раздел 15.7.7.19, «Оператор SHOW ERRORS».

event_scheduler

Эта переменная включает или выключает, и запускает или останавливает Планировщик событий. Возможные значения статуса — ON, DISABLED, и DISABLED. Включение Планировщика событий OFF отличается от выключения Планировщика событий, которое требует установить статус в DISABLED. Эта переменная и её влияние на работу Планировщика событий рассматриваются более подробно в Разделе 27.5.2, «Настройка Планировщика событий»

explain_format

Эта переменная определяет формат вывода по умолчанию, используемый EXPLAIN в отсутствие опции FORMAT при отображении плана выполнения запроса. Возможные значения и их влияние перечислены здесь:

Настройка этой переменной также влияет на EXPLAIN ANALYZE. В этой цели DEFAULT и TRADITIONAL интерпретируются как TREE. Если значение explain_format равно JSON, и выпущен оператор EXPLAIN ANALYZE без опции FORMAT, оператор возвращает ошибку.

Использование спецификатора формата с EXPLAIN или EXPLAIN ANALYZE переопределяет любые настройки для explain_format.

Переменная системы explain_format не оказывает никакого влияния на вывод EXPLAIN, когда этот оператор используется для отображения информации о столбцах таблицы.

Установка значения переменной explain_format в сеансе не требует специальных привилегий; установка на глобальном уровне требует SYSTEM_VARIABLES_ADMIN (или устаревшего SUPER привилегии). См. Раздел 7.1.9.1, «Привилегии на переменные системы».

Для получения дополнительной информации и примеров см. Получение информации о плане выполнения.

explain_json_format_version

Определяет версию формата вывода JSON, используемого операторами EXPLAIN FORMAT=JSON. Установка этой переменной в значение 1 заставляет сервер использовать версию 1, которая является линейным форматом, используемым для вывода из таких операторов в более ранних версиях MySQL; это значение по умолчанию в MySQL 9.2. Установка explain_json_format_version в 2 заставляет использовать формат версии 2; этот формат вывода JSON основан на путях доступа и предназначен для лучшей совместимости с будущими версиями оптимизатора MySQL. В MySQL 9.2 и более поздних версиях также включает версию формата JSON в своем выводе.

Пример использования см. в Получение информации о плане выполнения.

explicit_defaults_for_timestamp

Эта системная переменная определяет, включает ли сервер определённые нестандартные параметры по умолчанию и обработку значений NULL в столбцах TIMESTAMP. По умолчанию explicit_defaults_for_timestamp включён, что отключает нестандартные параметры. Отключение explicit_defaults_for_timestamp приводит к предупреждению.

Если explicit_defaults_for_timestamp отключён, сервер включает нестандартные параметры и обрабатывает столбцы TIMESTAMP следующим образом:

Описанные выше нестандартные параметры устарели; ожидается, что они будут удалены в будущих выпусках MySQL.

Если explicit_defaults_for_timestamp включён, сервер отключает нестандартные параметры и обрабатывает столбцы TIMESTAMP следующим образом:

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

[Warning] TIMESTAMP with implicit DEFAULT value is deprecated.
Please use --explicit_defaults_for_timestamp server option (see
documentation for more details).

Как указано в предупреждении, чтобы отключить устаревшие нестандартные параметры, включите системную переменную explicit_defaults_for_timestamp при запуске сервера.

Дополнительную информацию см. в Разделе 13.2.5, «Автоматическое инициализирование и обновление для TIMESTAMP и DATETIME».

external_user

Имя внешнего пользователя, используемое во время процесса аутентификации, заданное плагином, используемым для аутентификации клиента. При использовании родной (встроенной) аутентификации MySQL или если плагин не задаёт значение, эта переменная равна NULL. См. Раздел 8.2.19, «Пользователи-прокси».

flush

Если ON, сервер очищает (синхронизирует) все изменения на диске после каждого оператора SQL. Обычно MySQL выполняет запись всех изменений на диск только после каждого оператора SQL и позволяет операционной системе обрабатывать синхронизацию с диском. См. Раздел B.3.3.3, «Что делать, если MySQL постоянно аварийно завершает работу». Эта переменная устанавливается в ON, если вы запускаете mysqld с помощью параметра --flush.

flush_time

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

foreign_key_checks

Если установлено значение 1 (по умолчанию), ограничения внешних ключей проверяются. Если установлено значение 0, ограничения внешних ключей игнорируются, за несколькими исключениями. При повторном создании удаленной таблицы возвращается ошибка, если определение таблицы не соответствует ограничениям внешних ключей, ссылающимся на таблицу. Аналогично, операция ALTER TABLE возвращает ошибку, если определение внешнего ключа сформировано неправильно. Для получения дополнительной информации см. Раздел 15.1.21.5, «Ограничения FOREIGN KEY».

Установка этой переменной оказывает такое же влияние на таблицы NDB, как и на таблицы InnoDB. Обычно вы оставляете этот параметр включенным во время нормальной работы, чтобы обеспечить принудительное выполнение. Отключение проверки внешних ключей может быть полезно для перезагрузки таблиц InnoDB в порядке, отличном от требуемого их родительскими/дочерними отношениями. См. Раздел 15.1.21.5, «Ограничения FOREIGN KEY».

Установка foreign_key_checks в 0 также влияет на операторы определения данных: DROP SCHEMA удаляет схему, даже если она содержит таблицы, имеющие внешние ключи, на которые ссылаются таблицы за пределами схемы, и DROP TABLE удаляет таблицы, имеющие внешние ключи, на которые ссылаются другие таблицы.

ft_boolean_syntax

Список операторов, поддерживаемых булевыми полнотекстовыми поисками, выполняемыми с помощью IN BOOLEAN MODE. См. Раздел 14.9.2, «Булевы полнотекстовые поиски».

Значение переменной по умолчанию — '+ -><()~*:""&|'. Правила изменения значения следующие:

ft_max_word_len

Максимальная длина слова, которое будет включено в индекс MyISAM FULLTEXT.

ft_min_word_len

Минимальная длина слова, которое должно быть включено в индекс MyISAM FULLTEXT.

ft_query_expansion_limit

Количество лучших совпадений, используемых для поиска по полному тексту, выполненного с использованием WITH QUERY EXPANSION.

ft_stopword_file

Файл, из которого следует читать список стоп-слов для поиска по полному тексту в таблицах MyISAM. Сервер ищет файл в каталоге данных, если не указано абсолютное имя пути для указания другого каталога. Используются все слова из файла; комментарии не учитываются. По умолчанию используется встроенный список стоп-слов (как определено в файле storage/myisam/ft_static.c). Установка этой переменной в пустую строку ('') отключает фильтрацию стоп-слов. См. также Раздел 14.9.4, «Стоп-слова полного текста».

general_log

Включен ли общий журнал запросов. Значение может быть 0 (или OFF) для отключения журнала или 1 (или ON) для включения журнала. Назначение для вывода журнала управляется системной переменной log_output; если это значение равно NONE, записи журнала не записываются, даже если журнал включен.

general_log_file

Имя файла общего журнала запросов. Значение по умолчанию — host_name.log, но начальное значение может быть изменено с помощью параметра --general_log_file.

generated_random_password_length

Максимальное количество символов, разрешенных в случайных паролях, сгенерированных для CREATE USER, ALTER USER и SET PASSWORD операторов. Для получения дополнительной информации см. Генерация случайных паролей.

global_connection_memory_limit

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

Память, используемая системными пользователями, такими как пользователь root MySQL, включается в этот итог, но не учитывается для ограничения отключения; такие пользователи никогда не отключаются из-за использования памяти.

Память, используемая буферным пулом InnoDB, исключается из общего итога.

Для установки этой переменной необходимо иметь привилегию SYSTEM_VARIABLES_ADMIN или SUPER.

global_connection_memory_status_limit

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

global_connection_memory_tracking

Определяет, вычисляет ли сервер Global_connection_memory. Эта переменная должна быть явно включена; в противном случае вычисление памяти не выполняется, и Global_connection_memory не устанавливается.

Для установки этой переменной требуется привилегия SYSTEM_VARIABLES_ADMIN или SUPER.

group_concat_max_len

Максимальная длина результата в байтах для функции GROUP_CONCAT(). Значение по умолчанию равно 1024.

have_compress

YES, если сжатие zlib доступно серверу, NO — в противном случае. Если нет, функции COMPRESS() и UNCOMPRESS() использовать нельзя.

have_dynamic_loading

YES, если mysqld поддерживает динамическую загрузку плагинов, NO — в противном случае. Если значение равно NO, вы не можете использовать такие параметры, как --plugin-load для загрузки плагинов при запуске сервера, или оператор INSTALL PLUGIN для загрузки плагинов во время выполнения.

have_geometry

YES, если сервер поддерживает пространственные типы данных, NO — в противном случае.

have_profiling

YES, если функция профилирования операторов доступна, NO — в противном случае. При наличии, переменная системы profiling управляет включением или отключением этой возможности. См. Раздел 15.7.7.33, «Оператор SHOW PROFILES».

Эта переменная устарела; ожидается, что она будет удалена в будущих версиях MySQL.

have_query_cache

have_query_cache устарела, всегда имеет значение NO, и ожидается, что она будет удалена в будущих версиях MySQL.

have_rtree_keys

YES, если индексы RTREE доступны, NO — в противном случае. (Используются для пространственных индексов в таблицах MyISAM.)

have_statement_timeout

Доступна ли функция таймаута выполнения операторов (см. Подсказки оптимизатора для времени выполнения операторов). Значение может быть NO, если фоновый поток, используемый этой функцией, не удалось инициализировать.

have_symlink

YES, если поддержка символических ссылок включена, NO — в противном случае. Это необходимо на Unix для поддержки опций таблиц DATA DIRECTORY и INDEX DIRECTORY. Если сервер запущен с опцией --skip-symbolic-links, значение равно DISABLED.

Эта переменная не имеет смысла в Windows.

histogram_generation_max_mem_size

Максимальный объем памяти, доступный для генерации статистических данных гистограммы. См. Раздел 10.9.6, «Статистика оптимизатора» и Раздел 15.7.3.1, «Оператор ANALYZE TABLE».

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

host_cache_size

Сервер MySQL поддерживает кеш хостов в оперативной памяти, содержащий информацию об имени хоста и IP-адресе клиента и используемый для избежания запросов к системе доменных имён (DNS); см. Раздел 7.1.12.3, «Запросы к DNS и кэшу хостов».

Переменная host_cache_size управляет размером кэша хостов, а также размером таблицы Performance Schema host_cache, которая предоставляет содержимое кэша. Установка host_cache_size оказывает следующее влияние:

Значение по умолчанию автоматически устанавливается в 128, плюс 1 для значения max_connections до 500, плюс 1 за каждый приращение на 20 больше 500 в значении max_connections, ограниченное значением 2000.

hostname

Сервер устанавливает значение этой переменной в имя хоста сервера при запуске. Максимальная длина составляет 255 символов.

identity

Эта переменная является синонимом переменной last_insert_id. Она существует для совместимости с другими базами данных. Вы можете прочитать её значение с помощью SELECT @@identity, и установить её с помощью SET identity.

init_connect

Строка, которая должна быть выполнена сервером для каждого подключающегося клиента. Строка состоит из одной или нескольких SQL-команд, разделённых символами точки с запятой.

Для пользователей, имеющих привилегию CONNECTION_ADMIN (или устаревшую привилегию SUPER), содержимое init_connect не выполняется. Это сделано для того, чтобы ошибочное значение init_connect не препятствовало подключению всех клиентов. Например, значение может содержать оператор с синтаксической ошибкой, что приведет к сбоям подключений клиентов. Невыполнение init_connect для пользователей, имеющих привилегию CONNECTION_ADMIN или SUPER, позволяет им открыть подключение и исправить значение init_connect.

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

Сервер отбрасывает любые наборы результатов, полученные операторами в значении init_connect.

information_schema_stats_expiry

Некоторые INFORMATION_SCHEMA таблицы содержат столбцы, которые предоставляют статистику по таблицам:

STATISTICS.CARDINALITY
TABLES.AUTO_INCREMENT
TABLES.AVG_ROW_LENGTH
TABLES.CHECKSUM
TABLES.CHECK_TIME
TABLES.CREATE_TIME
TABLES.DATA_FREE
TABLES.DATA_LENGTH
TABLES.INDEX_LENGTH
TABLES.MAX_DATA_LENGTH
TABLES.TABLE_ROWS
TABLES.UPDATE_TIME

Эти столбцы представляют динамические метаданные таблиц; то есть информацию, которая меняется по мере изменения содержимого таблиц.

По умолчанию MySQL извлекает кэшированные значения для этих столбцов из словарей mysql.index_stats и mysql.table_stats, когда столбцы запрашиваются, что более эффективно, чем прямое извлечение статистики из хранилища. Если кэшированная статистика недоступна или истекла, MySQL извлекает последнюю статистику из хранилища и кэширует её в словарях mysql.index_stats и mysql.table_stats. Последующие запросы извлекают кэшированную статистику до истечения срока действия кэшированной статистики. Перезагрузка сервера или первое открытие таблиц mysql.index_stats и mysql.table_stats не обновляют кэшированную статистику автоматически.

Сеансовая переменная information_schema_stats_expiry определяет период времени до истечения срока действия кэшированной статистики. По умолчанию это 86400 секунд (24 часа), но этот период может быть продлён до одного года.

Чтобы обновить кэшированные значения в любое время для заданной таблицы, используйте ANALYZE TABLE.

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

Запрос столбцов статистики не сохраняет и не обновляет статистику в словарях mysql.index_stats и mysql.table_stats в следующих случаях:

Кэш статистики может быть обновлён в ходе многострочной транзакции до того, как будет известно, завершит ли транзакция выполнение. В результате кэш может содержать информацию, которая не соответствует известному состоянию завершения транзакции. Это может произойти с autocommit=0 или после START TRANSACTION.

information_schema_stats_expiry — сеансовая переменная, и каждый сеанс клиента может определить своё собственное значение истечения срока действия. Статистика, извлечённая из хранилища и кэшированная одним сеансом, доступна другим сеансам.

Для получения дополнительной информации см. Раздел 10.2.3, «Оптимизация запросов к INFORMATION_SCHEMA».

init_file

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

Если сервер запускается с опцией --initialize или --initialize-insecure, он работает в режиме загрузки и некоторые функции недоступны, что ограничивает разрешенные в файле запросы. Это включает запросы, связанные с управлением учетными записями (такие как CREATE USER или GRANT), репликацией и глобальными идентификаторами транзакций. См. Раздел 19.1.3, «Репликация с глобальными идентификаторами транзакций».

Потоки, созданные во время запуска сервера, используются для задач, таких как создание словаря данных, выполнение процедур обновления и создание системных таблиц. Для обеспечения стабильной и предсказуемой среды эти потоки выполняются со значениями по умолчанию сервера для некоторых системных переменных, таких как sql_mode, character_set_server, collation_server, completion_type, explicit_defaults_for_timestamp и default_table_encryption.

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

innodb_xxx

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

insert_id

Значение, которое будет использоваться следующим запросом INSERT или ALTER TABLE при вставке значения AUTO_INCREMENT. Это в основном используется с бинарным журналом.

interactive_timeout

Количество секунд, которое сервер ожидает активности по интерактивному соединению перед его закрытием. Интерактивный клиент определяется как клиент, использующий опцию CLIENT_INTERACTIVE. См. также wait_timeout.

internal_tmp_mem_storage_engine

Двигатель хранения для временных внутренних таблиц в памяти (см. Раздел 10.4.4, «Использование внутренних временных таблиц в MySQL»). Разрешенные значения — TempTable (по умолчанию) и MEMORY.

Использует двигатель хранения, определенный переменной internal_tmp_mem_storage_engine, для временных внутренних таблиц в памяти.

Настройка сеансового значения для internal_tmp_mem_storage_engine требует привилегии SESSION_VARIABLES_ADMIN или SYSTEM_VARIABLES_ADMIN.

Размер буфера соединения

Минимальный размер буфера, используемого для простых сканирований индексов, сканирований индексов диапазона и соединений, не использующих индексы и, следовательно, выполняющих полное сканирование таблицы. Эта переменная также контролирует количество памяти, используемой для соединения хеш-типов. Обычно лучший способ получить быстрые соединения — добавить индексы. Увеличьте значение join_buffer_size, чтобы получить более быстрое полное соединение, когда добавление индексов невозможно. Для каждого полного соединения между двумя таблицами выделяется один буфер соединения. Для сложного соединения между несколькими таблицами, для которых не используются индексы, может потребоваться несколько буферов соединения.

Значение по умолчанию составляет 256 КБ. Максимально допустимое значение для join_buffer_size составляет 4 ГБ−1. Более крупные значения разрешены для 64-битных платформ (за исключением 64-битных систем Windows, для которых большие значения усекаются до 4 ГБ−1 с предупреждением). Размер блока равен 128, а значение, которое не является точным кратным размеру блока, округляется MySQL Server вниз до ближайшего меньшего кратного размера блока перед сохранением значения для переменной системы. Парсер допускает значения до максимального беззнакового целого значения для платформы (4294967295 или 2³²−1 для 32-битной системы, 18446744073709551615 или 2⁶⁴−1 для 64-битной системы), но фактическое максимальное значение меньше, чем размер блока.

Если не используется алгоритм Block Nested-Loop или Batched Key Access, увеличение размера буфера больше, чем требуется для хранения каждой совпадающей строки, не принесёт пользы, и все соединения выделяют, по крайней мере, минимальный размер, поэтому будьте осторожны при настройке этой переменной на большое значение в глобальном масштабе. Лучше сохранить глобальное значение небольшим и изменить значение сеанса на большее только в сеансах, выполняющих крупные соединения, или изменить значение на основе запроса, используя подсказку оптимизатора SET_VAR (см. Раздел 10.9.3, «Подсказки оптимизатора»). Время выделения памяти может привести к существенному снижению производительности, если глобальный размер больше, чем требуется большинству запросов, использующих его.

При использовании Block Nested-Loop больший буфер соединения может быть полезен до тех пор, пока все необходимые столбцы из всех строк в первой таблице не будут сохранены в буфере соединения. Это зависит от запроса; оптимальный размер может быть меньше, чем хранение всех строк из первой таблицы.

При использовании Batched Key Access значение join_buffer_size определяет, насколько большой пакет ключей находится в каждом запросе к хранилищу данных. Чем больше буфер, тем больше последовательного доступа к правой таблице операции соединения, что может значительно повысить производительность.

Дополнительную информацию о буферизации соединения см. в Разделе 10.2.1.7, «Алгоритмы соединения Nested-Loop». Информацию о Batched Key Access см. в Разделе 10.2.1.12, «Соединения Block Nested-Loop и Batched Key Access». Информацию о соединениях хеш-типов см. в Разделе 10.2.1.4, «Оптимизация соединения Hash Join».

keep_files_on_create

Если таблица MyISAM создается без опции DATA DIRECTORY, файл .MYD создается в каталоге базы данных. По умолчанию, если MyISAM находит существующий файл .MYD в этом случае, он перезаписывает его. То же самое относится к файлам .MYI для таблиц, созданных без опции INDEX DIRECTORY. Чтобы подавить это поведение, установите переменную keep_files_on_create в значение ON (1), в этом случае MyISAM не перезаписывает существующие файлы и вместо этого возвращает ошибку. Значение по умолчанию — OFF (0).

Если таблица MyISAM создается с опцией DATA DIRECTORY или INDEX DIRECTORY и обнаружен существующий файл .MYD или .MYI, MyISAM всегда возвращает ошибку. Он не перезаписывает файл в указанном каталоге.

key_buffer_size

Блоки индексов для таблиц MyISAM буферизуются и разделяются всеми потоками. key_buffer_size — это размер буфера, используемого для блоков индексов. Буфер ключей также известен как кэш ключей.

Минимальное допустимое значение — 0, но вы не можете динамически установить key_buffer_size в 0. Установка значения 0 приводит к отбрасыванию кэша ключей, что запрещено во время выполнения. Установка key_buffer_size в 0 разрешается только при запуске, в этом случае кэш ключей не инициализируется. Изменение значения key_buffer_size во время выполнения со значения 0 на допустимое ненулевое значение инициализирует кэш ключей.

key_buffer_size можно увеличивать или уменьшать только на приращения или кратные 4096 байтам. Увеличение или уменьшение значения на несоответствующую величину приводит к предупреждению и обрезает значение до соответствующего значения.

Максимальное допустимое значение для key_buffer_size составляет 4 ГБ−1 на 32-битных платформах. Более высокие значения допустимы для 64-битных платформ. Эффективный максимальный размер может быть меньше, в зависимости от доступной физической ОЗУ и лимитов памяти на процесс, налагаемых операционной системой или аппаратной платформой. Значение этой переменной указывает на запрашиваемый объем памяти. Внутренне сервер выделяет как можно больше памяти до этого значения, но фактическое выделение может быть меньше.

Вы можете увеличить значение, чтобы получить лучшую обработку индексов для всех чтений и множественных записей; на системе, основной функцией которой является запуск MySQL с использованием хранилища MyISAM, 25% от всей памяти машины является приемлемым значением для этой переменной. Однако следует учитывать, что если вы сделаете значение слишком большим (например, более чем 50% от всей памяти машины), ваша система может начать страничную подкачку и станет очень медленной. Это происходит потому, что MySQL полагается на операционную систему для выполнения кэширования файловой системы для чтения данных, поэтому вы должны оставить место для кэша файловой системы. Также следует учитывать требования к памяти любых других двигателей хранилища, которые вы можете использовать в дополнение к MyISAM.

Для еще большей скорости при записи большого количества строк одновременно используйте LOCK TABLES. См. Раздел 10.2.5.1, «Оптимизация операторов INSERT».

Вы можете проверить производительность буфера ключей, выполнив оператор SHOW STATUS и рассмотрев переменные состояния Key_read_requests, Key_reads, Key_write_requests и Key_writes. (См. Раздел 15.7.7, «Операторы SHOW».) Отношение Key_reads/Key_read_requests обычно должно быть меньше 0,01. Отношение Key_writes/Key_write_requests обычно близко к 1, если вы в основном используете обновления и удаления, но может быть намного меньше, если вы склонны выполнять обновления, затрагивающие много строк одновременно, или если вы используете опцию таблицы DELAY_KEY_WRITE.

Долю буфера ключей, находящегося в использовании, можно определить, используя key_buffer_size в сочетании со статусной переменной Key_blocks_unused и размером блока буфера, доступным из системной переменной key_cache_block_size:

1 - ((Key_blocks_unused * key_cache_block_size) / key_buffer_size)

Это приблизительное значение, потому что часть пространства в буфере ключей выделяется внутренне для административных структур. Факторы, влияющие на объем накладных расходов для этих структур, включают размер блока и размер указателя. По мере увеличения размера блока процент буфера ключей, теряемый накладными расходами, имеет тенденцию уменьшаться. Более крупные блоки приводят к меньшему количеству операций чтения (потому что больше ключей получается за одно чтение), но, наоборот, к увеличению чтений ключей, которые не проверяются (если не все ключи в блоке не имеют отношения к запросу).

Возможна реализация нескольких MyISAM кэшей ключей. Предел размера 4 ГБ относится к каждому кэшу индивидуально, а не как к группе. См. Раздел 10.10.2, «Кэш ключей MyISAM».

key_cache_age_threshold

Это значение управляет понижением буферов из горячего подсписка кэша ключей в теплый подсписк. Более низкие значения приводят к более быстрому понижению. Минимальное значение — 100. Значение по умолчанию — 300. См. Раздел 10.10.2, «Кэш ключей MyISAM».

key_cache_block_size

Размер блоков в кэше ключей в байтах. Значение по умолчанию — 1024. См. Раздел 10.10.2, «Кэш ключей MyISAM».

key_cache_division_limit

Точка разделения между горячим и теплым подсписками списка буфера кэша ключей. Значение представляет собой процент списка буфера, используемого для теплого подсписка. Допустимые значения находятся в диапазоне от 1 до 100. Значение по умолчанию — 100. См. Раздел 10.10.2, «Кэш ключей MyISAM».

large_files_support

Была ли mysqld скомпилирована с опциями для поддержки больших файлов.

large_pages

Включена ли поддержка больших страниц (через опцию --large-pages). См. Раздел 10.12.3.3, «Включение поддержки больших страниц».

large_page_size

Если включена поддержка больших страниц, это показывает размер страниц памяти. Большие страницы памяти поддерживаются только в Linux; на других платформах значение этой переменной всегда равно 0. См. Раздел 10.12.3.3, «Включение поддержки больших страниц».

last_insert_id

Значение, которое будет возвращено из LAST_INSERT_ID(). Это хранится в бинарном журнале, когда вы используете LAST_INSERT_ID() в операторе, который обновляет таблицу. Установка этой переменной не обновляет значение, возвращаемое функцией C API.

lc_messages

Локаль, используемая для сообщений об ошибках. Значение по умолчанию — en_US. Сервер преобразует аргумент в имя языка и объединяет его со значением lc_messages_dir для определения местоположения файла сообщений об ошибках. См. Раздел 12.12, «Установка языка сообщений об ошибках».

lc_messages_dir

Каталог, в котором расположены сообщения об ошибках. Сервер использует это значение вместе со значением lc_messages для определения местоположения файла сообщений об ошибках. См. Раздел 12.12, «Установка языка сообщений об ошибках».

lc_time_names

Эта переменная указывает локаль, которая управляет языком, используемым для отображения названий и сокращений дней и месяцев. Эта переменная влияет на вывод функций DATE_FORMAT(), DAYNAME() и MONTHNAME(). Имена локалей — это значения в стиле POSIX, такие как 'ja_JP' или 'pt_BR'. Значение по умолчанию — 'en_US' независимо от настроек локали вашей системы. Для получения дополнительной информации см. Раздел 12.16, «Поддержка локали сервера MySQL».

license

Тип лицензии сервера.

local_infile

Эта переменная управляет возможностью загрузки локальных файлов на стороне сервера для операторов LOAD DATA. В зависимости от настройки local_infile, сервер отказывает или разрешает загрузку локальных данных клиентами, у которых LOCAL включена на стороне клиента.

Чтобы явно заставить сервер отклонять или разрешать операторы LOAD DATA LOCAL (независимо от того, как клиентские программы и библиотеки настроены во время компиляции или выполнения), запустите mysqld с отключенной или включенной local_infile соответственно. local_infile также можно установить во время выполнения. Для получения дополнительной информации см. Раздел 8.1.6, «Вопросы безопасности для LOAD DATA LOCAL».

lock_wait_timeout

Эта переменная задаёт время ожидания в секундах для попыток получения блокировок метаданных. Допустимые значения находятся в диапазоне от 1 до 31536000 (1 год). Значение по умолчанию — 31536000.

Это время ожидания применяется ко всем операторам, использующим блокировки метаданных. К ним относятся операции DML и DDL над таблицами, представлениями, хранимыми процедурами и хранимыми функциями, а также операторы LOCK TABLES, FLUSH TABLES WITH READ LOCK и HANDLER.

Это время ожидания не применяется к неявным доступам к системным таблицам в базе данных mysql, таким как таблицы предоставления прав, изменяемые операторами GRANT или REVOKE, или операторам ведения журнала таблиц. Время ожидания применяется к системным таблицам, к которым осуществляется прямой доступ, например, с помощью операторов SELECT или UPDATE.

Значение времени ожидания применяется отдельно для каждой попытки блокировки метаданных. Заданный оператор может потребовать более одной блокировки, поэтому возможно, что оператор будет заблокирован дольше, чем значение lock_wait_timeout, прежде чем будет выведена ошибка времени ожидания. При возникновении тайм-аута блокировки, выводится сообщение об ошибке.

lock_wait_timeout также определяет количество времени, в течение которого оператор LOCK INSTANCE FOR BACKUP ожидает блокировку, прежде чем отказаться.

locked_in_memory

Была ли mysqld заблокирована в памяти с помощью --memlock.

log_error

Целевой файл журнала ошибок по умолчанию. Если целевым объектом является консоль, значение равно stderr. В противном случае целевым объектом является файл, и значение log_error является именем файла. См. Раздел 7.4.2, «Журнал ошибок».

log_error_services

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

Любой загружаемый (не встроенный) компонент, указанный в log_error_services, неявно загружается, если он ещё не загружен. Для получения дополнительной информации см. Раздел 7.4.2.1, «Конфигурация журнала ошибок».

log_error_suppression_list

Системная переменная log_error_suppression_list применяется к событиям, предназначенным для журнала ошибок, и указывает, какие события следует подавлять при их возникновении с приоритетом WARNING или INFORMATION. Например, если определённый тип предупреждения считается нежелательным “шумом” в журнале ошибок, поскольку он часто встречается, но не представляет интереса, его можно подавить. Эта переменная влияет на фильтрацию, выполняемую компонентом фильтра журнала ошибок log_filter_internal, который включен по умолчанию (см. Раздел 7.5.3, «Компоненты журнала ошибок»). Если log_filter_internal отключен, log_error_suppression_list не оказывает никакого действия.

Значение log_error_suppression_list может быть пустой строкой для отсутствия подавления или списком из одного или нескольких значений, разделённых запятыми, указывающих коды ошибок, которые необходимо подавить. Коды ошибок могут быть указаны в символьной или числовой форме. Числовой код может быть указан с префиксом MY- или без него. Нули в начале числовой части не имеют значения. Примеры допустимых форматов кодов:

ER_SERVER_SHUTDOWN_COMPLETE
MY-000031
000031
MY-31
31

Символьные значения предпочтительнее числовых значений для читаемости и переносимости. Информация о допустимых символах и номерах ошибок см. в .

Действие log_error_suppression_list сочетается с действием log_error_verbosity. Для получения дополнительной информации см. Раздел 7.4.2.5, «Фильтрация журнала ошибок на основе приоритета (log_filter_internal)».

log_error_verbosity

Системная переменная log_error_verbosity задаёт уровень детализации обработки событий, предназначенных для файла ошибок. Эта переменная влияет на фильтрацию, выполняемую компонентом фильтра журнала ошибок log_filter_internal, который включён по умолчанию (см. Раздел 7.5.3, «Компоненты журнала ошибок»). Если log_filter_internal отключен, log_error_verbosity не оказывает никакого влияния.

События, предназначенные для журнала ошибок, имеют приоритет ERROR, WARNING или INFORMATION. log_error_verbosity управляет уровнем детализации на основе того, какие приоритеты разрешены для сообщений, записываемых в журнал, как показано в следующей таблице.

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

Влияние log_error_verbosity сочетается с влиянием log_error_suppression_list. Для получения дополнительной информации см. Раздел 7.4.2.5, «Фильтрация журнала ошибок на основе приоритета (log_filter_internal)».

log_output

Назначение или назначения для вывода общего журнала запросов и журнала медленных запросов. Значение представляет собой список из одного или нескольких слов, разделённых запятыми, выбранных из TABLE, FILE и NONE. TABLE выбирает запись в таблицы general_log и slow_log в схеме системы mysql. FILE выбирает запись в файлы журналов. NONE отключает запись в журналы. Если NONE присутствует в значении, оно имеет приоритет над любыми другими словами, которые присутствуют. TABLE и FILE могут быть указаны одновременно, чтобы выбрать оба места назначения вывода журнала.

Эта переменная выбирает места назначения вывода журнала, но не включает вывод журнала. Для этого включите системные переменные general_log и slow_query_log. Для ведения журнала FILE системные переменные general_log_file и slow_query_log_file определяют местоположения файлов журналов. Для получения дополнительной информации см. Раздел 7.4.1, «Выбор мест назначения вывода общего журнала запросов и журнала медленных запросов».

log_queries_not_using_indexes

Если включить эту переменную при включённом журнале медленных запросов, будут регистрироваться запросы, которые, как ожидается, извлекут все строки. См. Раздел 7.4.5, «Журнал медленных запросов». Этот параметр не обязательно означает, что индекс не используется. Например, запрос, использующий полное сканирование индекса, использует индекс, но будет зарегистрирован, поскольку индекс не будет ограничивать количество строк.

log_raw

Системная переменная log_raw изначально устанавливается в значение параметра --log-raw. См. описание этого параметра для получения дополнительной информации. Системная переменная также может быть установлена во время выполнения для изменения поведения маскировки паролей.

log_slow_admin_statements

Включить медленные административные операторы в операторы, записываемые в журнал медленных запросов. Административные операторы включают ALTER TABLE, ANALYZE TABLE, CHECK TABLE, CREATE INDEX, DROP INDEX, OPTIMIZE TABLE и REPAIR TABLE.

log_slow_extra

Если включён журнал медленных запросов и место назначения вывода включает FILE, сервер записывает дополнительные поля в строки файла журнала, которые предоставляют информацию о медленных операторах. См. Раздел 7.4.5, «Журнал медленных запросов». Вывод TABLE не изменяется.

log_timestamps

Эта переменная управляет часовым поясом метки времени в сообщениях, записываемых в журнал ошибок, а также в сообщениях журнала запросов и журнала медленных запросов, записанных в файлы. Она не влияет на часовой пояс общих сообщений журнала запросов и журнала медленных запросов, записанных в таблицы (mysql.general_log, mysql.slow_log). Строки, извлеченные из этих таблиц, можно преобразовать из локального часового пояса системы в любой желаемый часовой пояс с помощью CONVERT_TZ() или путем установки системной переменной сеанса time_zone.

Разрешенные значения log_timestamps — это UTC (значение по умолчанию) и SYSTEM (локальный часовой пояс системы).

Метки времени записываются в формате ISO 8601/RFC 3339: YYYY-MM-DDThh:mm:ss.uuuuuu плюс хвостовое значение Z, обозначающее время по Гринвичу (UTC), или ±hh:mm (смещение относительно UTC).

log_throttle_queries_not_using_indexes

Если log_queries_not_using_indexes включен, переменная log_throttle_queries_not_using_indexes ограничивает количество таких запросов в минуту, которые могут быть записаны в журнал медленных запросов. Значение 0 (значение по умолчанию) означает «без ограничения». Дополнительную информацию см. в разделе 7.4.5, «Журнал медленных запросов».

long_query_time

Если запрос занимает больше этого количества секунд, сервер увеличивает значение переменной состояния Slow_queries. Если журнал медленных запросов включен, запрос записывается в файл журнала медленных запросов. Это значение измеряется в реальном времени, а не во времени выполнения CPU, поэтому запрос, находящийся ниже порога на слабо загруженной системе, может оказаться выше порога на сильно загруженной. Минимальное и значение по умолчанию для long_query_time составляют 0 и 10 соответственно. Максимальное значение равно 31536000, что соответствует 365 дням в секундах. Значение можно указывать с точностью до микросекунд. См. раздел 7.4.5, «Журнал медленных запросов».

Меньшие значения этой переменной приводят к тому, что больше заявлений рассматриваются как длительные, что приводит к тому, что больше места требуется для журнала медленных запросов. Для очень малых значений (менее одной секунды) журнал может быстро увеличиваться в объеме. Увеличение количества заявлений, рассматриваемых как длительные, также может привести к ложным срабатываниям для предупреждения «Избыточное число длительных процессов» в MySQL Enterprise Monitor, особенно если включена репликация Group Replication. По этим причинам очень маленькие значения следует использовать только в тестовых средах или в производственных средах только в течение короткого периода времени.

mysqldump выполняет полный сканирование таблиц, что означает, что его запросы часто превышают значение long_query_time, которое полезно для обычных запросов. Если вы хотите исключить большинство или все запросы, сгенерированные mysqldump из журнала медленных запросов, вы можете использовать --mysqld-long-query-time, чтобы изменить значение переменной сеанса на более высокое.

low_priority_updates

Если установлено значение 1, все операторы INSERT, UPDATE, DELETE и LOCK TABLE WRITE ожидают, пока не завершатся все ожидающие SELECT или LOCK TABLE READ для затронутой таблицы. Тот же эффект можно получить, используя {INSERT | REPLACE | DELETE | UPDATE} LOW_PRIORITY ..., чтобы понизить приоритет только одного запроса. Эта переменная влияет только на хранилища данных, использующие только блокировку на уровне таблицы (например, MyISAM, MEMORY и MERGE). См. раздел 10.11.2, «Вопросы блокировки таблиц».

Установка значения сеанса этой системной переменной является ограниченной операцией. Пользователь сеанса должен иметь права, достаточные для установки ограниченных переменных сеанса. См. раздел 7.1.9.1, «Права на системные переменные».

lower_case_file_system

Эта переменная описывает чувствительность к регистру имен файлов в файловой системе, где находится каталог данных. OFF означает, что имена файлов чувствительны к регистру, а ON — что нет. Эта переменная является только для чтения, так как отражает атрибут файловой системы, и ее изменение не повлияет на файловую систему.

lower_case_table_names

Если значение установлено в 0, имена таблиц сохраняются как указано, и сравнения регистрозависимы. Если значение установлено в 1, имена таблиц хранятся в нижнем регистре на диске, и сравнения регистронезависимы. Если значение установлено в 2, имена таблиц сохраняются как указано, но сравниваются в нижнем регистре. Этот параметр также применяется к именам баз данных и псевдонимам таблиц. Дополнительные сведения см. в разделе 11.2.3 «Регистрозависимость идентификаторов».

Значение этой переменной зависит от платформы (см. lower_case_file_system). В Linux и других системах Unix по умолчанию установлено 0. В Windows значение по умолчанию равно 1. В macOS значение по умолчанию равно 2. В Linux (и других системах Unix) установка значения в 2 не поддерживается; сервер принудительно устанавливает значение в 0.

Не следует устанавливать lower_case_table_names в 0, если MySQL работает на системе, где каталоги данных находятся на файловой системе с регистронезависимым режимом (например, в Windows или macOS). Это недопустимая комбинация, которая может привести к зависанию при выполнении операции INSERT INTO ... SELECT ... FROM tbl_name с неправильным регистром символов tbl_name. При использовании MyISAM доступ к именам таблиц с разными регистрами символов может привести к повреждению индексов.

Если вы попытаетесь запустить сервер с --lower_case_table_names=0 на файловой системе с регистронезависимым режимом, выводится сообщение об ошибке, и сервер завершает работу.

Установка этой переменной влияет на поведение опций фильтрации репликации в отношении регистрозависимости. Дополнительные сведения см. в разделе 19.2.5 «Как серверы оценивают правила фильтрации репликации».

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

Поэтому необходимо настроить lower_case_table_names на желаемое значение до инициализации сервера. В большинстве случаев это требует настройки lower_case_table_names в файле параметров MySQL перед первым запуском сервера MySQL. Однако при установке с APT на Debian и Ubuntu сервер инициализируется за вас, и нет возможности настроить параметр в файле параметров заранее. Следовательно, необходимо использовать утилиту debconf-set-selection перед установкой MySQL с помощью APT для включения lower_case_table_names. Для этого выполните следующую команду перед установкой MySQL с помощью APT:

$> sudo debconf-set-selections <<< "mysql-server mysql-server/lowercase-table-names select Enabled"

mandatory_roles

Роли, которые сервер должен рассматривать как обязательные. По сути, эти роли автоматически предоставляются каждому пользователю, хотя установка mandatory_roles фактически не изменяет учетные записи пользователей, и предоставленные роли не видны в таблице системы mysql.role_edges.

Значение переменной представляет собой список имён ролей, разделенных запятыми. Пример:

SET PERSIST mandatory_roles = '`role1`@`%`,`role2`,role3,role4@localhost';

Для установки значения mandatory_roles в момент выполнения требуется привилегия ROLE_ADMIN в дополнение к привилегии SYSTEM_VARIABLES_ADMIN (или устаревшей привилегии SUPER), обычно требуемой для установки глобального значения системной переменной во время выполнения.

Имена ролей состоят из части имени пользователя и части имени хоста в формате user_name@host_name. Часть имени хоста, если она опущена, по умолчанию равна %. Дополнительную информацию см. в разделе 8.2.5 «Указание имён ролей».

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

Роли, указанные в значении mandatory_roles, нельзя отозвать с помощью REVOKE или удалить с помощью DROP ROLE или DROP USER.

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

Обязательные роли, как и явно предоставленные роли, не вступают в силу до активации (см. Активация ролей). Во время входа в систему активация ролей происходит для всех предоставленных ролей, если системная переменная activate_all_roles_on_login включена; в противном случае или для ролей, заданных как роли по умолчанию. Во время выполнения активация ролей происходит с помощью SET ROLE.

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

SHOW GRANTS отображает обязательные роли в соответствии с правилами, описанными в разделе 15.7.7.23 «Оператор SHOW GRANTS».

max_allowed_packet