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

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

В предыдущей таблице %WINDIR% представляет расположение каталога Windows. Это обычно C:\WINDOWS. Используйте следующую команду для определения точного расположения из значения переменной среды WINDIR:

C:\> echo %WINDIR%

%APPDATA% представляет значение каталога данных приложений Windows. Используйте следующую команду для определения точного расположения из значения переменной среды APPDATA:

C:\> echo %APPDATA%

BASEDIR представляет каталог базовой установки MySQL. Когда MySQL 8.4 устанавливается с помощью MSI, это обычно C:\PROGRAMDIR\MySQL\MySQL Server 8.4, где PROGRAMDIR представляет каталог программ (обычно Program Files для английских версий Windows).

DATADIR представляет каталог данных MySQL. Как используется для поиска mysqld-auto.cnf, его значение по умолчанию — расположение каталога данных, созданного при компиляции MySQL, но может быть изменено с помощью --datadir, указанного в файле параметров или параметре командной строки, обработанном до обработки mysqld-auto.cnf.

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

В предыдущей таблице ~ представляет домашний каталог текущего пользователя (значение $HOME).

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

MYSQL_HOME — переменная среды, содержащая путь к каталогу, в котором находится файл серверных параметров my.cnf. Если MYSQL_HOME не задано, а вы запускаете сервер с помощью программы mysqld_safe, то mysqld_safe устанавливает его в BASEDIR, каталог базовой установки MySQL.

DATADIR представляет каталог данных MySQL. Как используется для поиска mysqld-auto.cnf, его значение по умолчанию — расположение каталога данных, созданного при компиляции MySQL, но может быть изменено с помощью --datadir, указанного в файле параметров или параметре командной строки, обработанном до обработки mysqld-auto.cnf.

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

Следующее описание синтаксиса файла параметров относится к файлам, которые вы редактируете вручную. Это исключает .mylogin.cnf, который создается с помощью mysql_config_editor и зашифрован, и mysqld-auto.cnf, который сервер создаёт в формате JSON.

Любой длинный параметр, который можно указать в командной строке при запуске программы MySQL, также можно указать в файле параметров. Чтобы получить список доступных параметров для программы, запустите её с параметром --help. (Для mysqld используйте --verbose и --help.)

Синтаксис указания параметров в файле параметров аналогичен синтаксису командной строки (см. Раздел 6.2.2.1, «Использование параметров в командной строке»). Однако в файле параметров вы опускаете ведущие два дефиса из имени параметра и указываете только один параметр в строке. Например, --quick и --host=localhost в командной строке должны быть указаны как quick и host=localhost в отдельных строках файла параметров. Для указания параметра вида --loose-opt_name в файле параметров запишите его как loose-opt_name.

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

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

Вы можете использовать управляющие последовательности \b, \t, \n, \r, \\ и \s в значениях параметров для представления символов Backspace, Tab, Newline, Carriage Return, обратной косой черты и пробела соответственно. В файлах параметров эти правила экранирования действуют следующим образом:

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

Правила экранирования в файлах параметров немного отличаются от правил экранирования в строковых литералах в операторах SQL. В последнем случае, если “x” не является допустимым символом управляющей последовательности, \x становится “x”, а не \x. См. Раздел 11.1.1, «Строковые литералы».

Правила экранирования для значений файла параметров особенно важны для имён путей Windows, которые используют \ в качестве разделителя пути. Разделитель в имени пути Windows должен быть записан как \\, если за ним следует символ управляющей последовательности. Он может быть записан как \\ или \, если за ним не следует символ управляющей последовательности. Кроме того, / можно использовать в именах путей Windows и оно обрабатывается как \. Предположим, что вы хотите указать базовый каталог C:\Program Files\MySQL\MySQL Server 8.4 в файле параметров. Это можно сделать несколькими способами. Вот некоторые примеры:

basedir="C:\Program Files\MySQL\MySQL Server 8.4"
basedir="C:\\Program Files\\MySQL\\MySQL Server 8.4"
basedir="C:/Program Files/MySQL/MySQL Server 8.4"
basedir=C:\\Program\sFiles\\MySQL\\MySQL\sServer\s8.4

Если имя группы параметров совпадает с именем программы, параметры в группе применяются именно к этой программе. Например, группы [mysqld] и [mysql] применяются к серверу mysqld и программе-клиенту mysql соответственно.

Группа параметров [client] считывается всеми клиентскими программами, предоставленными в дистрибутивах MySQL (но не сервером mysqld). Чтобы понять, как программы клиентских сторон, использующие C API, могут использовать файлы параметров, см. документацию по C API по адресу .

Группа [client] позволяет задавать параметры, которые применяются ко всем клиентам. Например, [client] — подходящая группа для указания пароля для подключения к серверу. (Но убедитесь, что файл параметров доступен только вам, чтобы другие люди не могли узнать ваш пароль.) Не помещайте параметр в группу [client], если он не распознаётся всеми клиентскими программами, которые вы используете. Программы, которые не понимают параметр, прекращают работу после вывода сообщения об ошибке при попытке их запуска.

Список общих групп параметров следует помещать перед более специфичными. Например, группа [client] более общая, так как она считывается всеми клиентскими программами, в то время как группа [mysqldump] считывается только программой mysqldump. Параметры, указанные позже, переопределяют параметры, указанные ранее, поэтому размещение групп параметров в порядке [client], [mysqldump] позволяет параметрам, специфичным для mysqldump, переопределять параметры [client].

Вот пример типового глобального файла параметров:

[client]
port=3306
socket=/tmp/mysql.sock

[mysqld]
port=3306
socket=/tmp/mysql.sock
key_buffer_size=16M
max_allowed_packet=128M

[mysqldump]
quick

Вот пример типового файла параметров пользователя:

[client]
# The following password is sent to all standard MySQL clients
password="my password"

[mysql]
no-auto-rehash
connect_timeout=2

Для создания групп параметров, которые должны считываться только серверами mysqld из определённых серий выпусков MySQL, используйте группы с именами [mysqld-8.3], [mysqld-8.4] и так далее. Следующая группа указывает, что настройка sql_mode должна использоваться только серверами MySQL с номерами версии 8.4.x:

[mysqld-8.4]
sql_mode=TRADITIONAL

Можно использовать директивы !include в файлах параметров для включения других файлов параметров и !includedir для поиска файлов параметров в определённых директориях. Например, чтобы включить файл /home/mydir/myopt.cnf, используйте следующую директиву:

!include /home/mydir/myopt.cnf

Чтобы найти директорию /home/mydir и прочитать найденные там файлы параметров, используйте эту директиву:

!includedir /home/mydir

MySQL не гарантирует порядок чтения файлов параметров в директории.

Записывайте содержимое включённого файла параметров как любой другой файл параметров. То есть он должен содержать группы параметров, каждая из которых предваряется строкой [group], указывающей программу, к которой относятся параметры.

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

!include /home/mydir/myopt.cnf

И предположим, что /home/mydir/myopt.cnf выглядит так:

[mysqladmin]
force

[mysqld]
key_buffer_size=16M

Если my.cnf обрабатывается mysqld, используется только группа [mysqld] в файле /home/mydir/myopt.cnf. Если файл обрабатывается mysqladmin, используется только группа [mysqladmin]. Если файл обрабатывается любой другой программой, никакие параметры из /home/mydir/myopt.cnf не используются.

Директива !includedir обрабатывается аналогично, за исключением того, что все файлы параметров в указанной директории читаются.

Если файл параметров содержит директивы !include или !includedir, файлы, указанные этими директивами, обрабатываются всякий раз, когда обрабатывается файл параметров, независимо от их расположения в файле.

Для работы директив включения путь к файлу не должен быть указан в кавычках и не должен содержать управляющих последовательностей. Например, следующие инструкции, приведенные в my.ini, считывают файл параметров myopts.ini:

!include C:/ProgramData/MySQL/MySQL Server/myopts.ini
!include C:\ProgramData\MySQL\MySQL Server\myopts.ini
!include C:\\ProgramData\\MySQL\\MySQL Server\\myopts.ini

В Windows, если !include /path/to/extra.ini — последняя строка в файле, убедитесь, что в конце добавлена новая строка; в противном случае строка игнорируется.