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

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

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

C:\> echo %WINDIR%

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

C:\> echo %APPDATA%

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

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

В 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.

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

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

Вы можете использовать escape-последовательности \b, \t, \n, \r, \\ и \s в значениях параметров для представления символов backspace, tab, newline, carriage return, обратного слеша и пробела. В файлах параметров применяются следующие правила экранирования:

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

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

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

basedir="C:\Program Files\MySQL\MySQL Server 9.2"
basedir="C:\\Program Files\\MySQL\\MySQL Server 9.2"
basedir="C:/Program Files/MySQL/MySQL Server 9.2"
basedir=C:\\Program\sFiles\\MySQL\\MySQL\sServer\s9.2

Если имя группы параметров совпадает с именем программы, параметры в группе применяются конкретно к этой программе. Например, группы [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-9.1], [mysqld-9.2] и так далее. Следующая группа указывает, что значение sql_mode должно использоваться только серверами MySQL с номерами версии 9.2.x:

[mysqld-9.2]
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 — последняя строка в файле, убедитесь, что в конце добавлена новая строка; в противном случае строка игнорируется.