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_policy

Эта переменная используется для администрирования возможностей многофакторной аутентификации (MFA). Для операторов CREATE USER и ALTER USER, используемых для управления определениями учетных записей MySQL, она определяет, какой фактор или факторы аутентификации могут быть указаны, где “factor” соответствует методу аутентификации или подключаемому модулю, связанному с учетной записью. 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.6, «Подключаемая аутентификация Windows».

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

authentication_windows_use_principal_name

Эта переменная доступна только в том случае, если плагин проверки подлинности Windows authentication_windows включен. См. Раздел 8.4.1.6, «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 и ROLLBACK».

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

См. также Раздел 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.3, «Подключаемая аутентификация SHA-256» и Раздел 8.4.1.2, «Подключаемая аутентификация Caching 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.2, «Подключаемая аутентификация Caching SHA-2».

caching_sha2_password_public_key_path

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

Для получения информации о caching_sha2_password, включая информацию о том, как клиенты запрашивают открытый ключ RSA, см. Раздел 8.4.1.2, «Подключаемая аутентификация Caching 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 включена, сервер выполняет отображение пользователей-прокси для любых плагинов аутентификации, которые делают такой запрос. Возможно, также потребуется включить плагин-специфичные системные переменные, чтобы воспользоваться поддержкой отображения серверных пользователей-прокси:

Сведения о пользователях-прокси см. в Разделе 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.

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

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

connection_memory_limit

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

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

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

core_file

Флаг записи файла core при неожиданном завершении работы сервера. Эта переменная устанавливается параметром --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

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

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

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

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

Описание средства отладки синхронизации и использование точек синхронизации см. в MySQL Internals: Test Synchronization.

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: The end_markers_in_json System Variable.

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.18 «Оператор SHOW ERRORS».

event_scheduler

Эта переменная включает или отключает и запускает или останавливает планировщик событий. Возможные значения статуса — ON, OFF и DISABLED. Включение планировщика событий OFF отличается от его отключения, которое требует установки статуса в DISABLED. Более подробная информация о этой переменной и её влиянии на работу планировщика событий приведена в разделе 27.4.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 8.4. Установка explain_json_format_version в 2 заставляет использовать формат версии 2; этот формат JSON вывода основан на путях доступа и предназначен для лучшей совместимости с будущими версиями оптимизатора MySQL.

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

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.20.5, «Ограничения FOREIGN KEY».

Установка этой переменной оказывает такое же влияние на таблицы NDB, как и на таблицы InnoDB. Обычно вы оставляете этот параметр включенным во время нормальной работы, чтобы обеспечить принудительное выполнение. Отключение проверки внешних ключей может быть полезно для повторной загрузки таблиц InnoDB в порядке, отличном от требуемого их родительскими/дочерними отношениями. См. Раздел 15.1.20.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_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 (Domain Name System); см. Раздел 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

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

Значение по умолчанию — 256 КБ. Максимально допустимое значение для join_buffer_size составляет 4 ГБ−1. Более крупные значения разрешены для 64-битных платформ (за исключением 64-битной Windows, для которой большие значения усекаются до 4 ГБ−1 с предупреждением). Размер блока составляет 128, и значение, которое не является точным кратным размеру блока, округляется вниз до ближайшего меньшего кратного размера блока сервером MySQL перед сохранением значения системной переменной. Парсер допускает значения до максимального беззнакового целого значения для платформы (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». Информацию об обработке пакетов ключей см. в Разделе 10.2.1.12, «Объединения Block Nested-Loop и Batched Key Access». Информацию об объединениях хэш-типа см. в Разделе 10.2.1.4, «Оптимизация объединения хэш-типа».

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 Server».

license

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

local_infile

Эта переменная управляет возможностью сервера выполнять LOCAL для операторов 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. Если журнал медленных запросов включен, запрос регистрируется в файле журнала медленных запросов. Это значение измеряется в реальном времени, а не в процессорном времени, поэтому запрос, который находится ниже порогового значения на слабо загруженной системе, может быть выше порога на сильно загруженной. Минимальное и значение по умолчанию для long_query_time составляют 0 и 10 соответственно. Максимальное значение составляет 31536000, что соответствует 365 дням в секундах. Значение может быть указано с точностью до микросекунд. См. раздел 7.4.5, «Журнал медленных запросов».

Более низкие значения этой переменной приводят к тому, что больше операторов рассматриваются как длительно выполняющиеся, в результате чего требуется больше места для журнала медленных запросов. При очень малых значениях (менее одной секунды) журнал может быстро разрастись. Увеличение числа операторов, рассматриваемых как длительно выполняющиеся, также может привести к ложным срабатываниям предупреждения “Чрезмерное количество длительно выполняемых процессов” в MySQL Enterprise Monitor, особенно если включена репликация группы. По этим причинам очень малые значения следует использовать только в тестовых средах или, в производственных средах, только в течение короткого периода.

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.22, «Оператор SHOW GRANTS».

max_allowed_packet

Максимальный размер одного пакета или любой сгенерированной/промежуточной строки, или любого параметра, отправленного функцией C API. По умолчанию 64 МБ.

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

Необходимо увеличить это значение, если используются большие столбцы BLOB или длинные строки. Оно должно быть таким же большим, как самый большой BLOB, который вы хотите использовать. Предельное значение протокола для max_allowed_packet составляет 1 ГБ. Значение должно быть кратно 1024; значения, не кратные 1024, округляются вниз до ближайшего кратного.

При изменении размера буфера сообщений путём изменения значения переменной max_allowed_packet также необходимо изменить размер буфера на стороне клиента, если это позволяет ваша клиентская программа. Значение по умолчанию max_allowed_packet, встроенное в клиентскую библиотеку, составляет 1 ГБ, но отдельные клиентские программы могут его переопределить. Например, mysql и mysqldump имеют значения по умолчанию 16 МБ и 24 МБ соответственно. Они также позволяют изменить значение на стороне клиента, установив max_allowed_packet в командной строке или в файле параметров.

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

max_connect_errors

После max_connect_errors последовательных запросов подключения с одного хоста, прерванных без успешного подключения, сервер блокирует этот хост от дальнейших подключений. Если подключение с хоста установлено успешно в течение менее max_connect_errors попыток после предыдущего прерванного подключения, счётчик ошибок для хоста обнуляется. Для разблокировки заблокированных хостов очистите кэш хостов; см. Очистка кэша хостов.

max_connections