6.9 Environment Variables — MySQL 9.2

6.9 Переменные окружения

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

Параметры командной строки имеют приоритет над значениями, указанными в файлах параметров и переменных окружения, а значения в файлах параметров имеют приоритет над значениями в переменных окружения. Во многих случаях предпочтительнее использовать файл параметров вместо переменных окружения для изменения поведения MySQL. См. Раздел 6.2.2.2, «Использование файлов параметров».

Переменная	Описание
`AUTHENTICATION_KERBEROS_CLIENT_LOG`	Уровень ведения журнала аутентификации Kerberos.
`AUTHENTICATION_LDAP_CLIENT_LOG`	Уровень ведения журнала аутентификации LDAP на стороне клиента.
`AUTHENTICATION_PAM_LOG`	Настройки ведения журнала отладки плагина аутентификации PAM.
`CC`	Имя вашего компилятора C (для запуска CMake).
`CXX`	Имя вашего компилятора C++ (для запуска CMake).
`CC`	Имя вашего компилятора C (для запуска CMake).
`DBI_USER`	Имя пользователя по умолчанию для Perl DBI.
`DBI_TRACE`	Параметры отслеживания для Perl DBI.
`HOME`	Путь по умолчанию для файла истории mysql — `$HOME/.mysql_history`.
`LD_RUN_PATH`	Используется для указания расположения `libmysqlclient.so`.
`LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN`	Включить плагин аутентификации `mysql_clear_password`; см. Раздел 8.4.1.3, «Аутентификация на стороне клиента с открытым текстом».
`LIBMYSQL_PLUGIN_DIR`	Директория для поиска клиентских плагинов.
`LIBMYSQL_PLUGINS`	Клиентские плагины для предварительной загрузки.
`MYSQL_DEBUG`	Параметры отслеживания для отладки.
`MYSQL_GROUP_SUFFIX`	Значение суффикса группы параметров (как указание `--defaults-group-suffix`).
`MYSQL_HISTFILE`	Путь к файлу истории mysql. Если эта переменная задана, её значение переопределяет значение по умолчанию для `$HOME/.mysql_history`.
`MYSQL_HISTIGNORE`	Шаблоны, указывающие на то, что mysql не должен записывать в журнал в `$HOME/.mysql_history`, или `syslog`, если указан `--syslog`.
`MYSQL_HOME`	Путь к директории, в которой находится файл `my.cnf`, специфичный для сервера.
`MYSQL_HOST`	Имя хоста по умолчанию, используемое клиентом командной строки mysql.
`MYSQL_PS1`	Командная строка, которую нужно использовать в клиенте командной строки mysql.
`MYSQL_PWD`	Пароль по умолчанию при подключении к mysqld. Использование этого небезопасно. См. примечание под таблицей.
`MYSQL_TCP_PORT`	Номер порта TCP/IP по умолчанию.
`MYSQL_TEST_LOGIN_FILE`	Имя файла пути к подключению `.mylogin.cnf`.
`MYSQL_TEST_TRACE_CRASH`	Вызывает ли плагин отслеживания протокола тестирования сбой клиентов. См. примечание под таблицей.
`MYSQL_TEST_TRACE_DEBUG`	Выводит ли плагин отслеживания протокола тестирования вывод. См. примечание под таблицей.
`MYSQL_UNIX_PORT`	Имя файла сокета Unix по умолчанию; используется для подключений к `localhost`.
`MYSQLX_TCP_PORT`	Номер порта TCP/IP по умолчанию плагина X.
`MYSQLX_UNIX_PORT`	Имя файла сокета Unix по умолчанию плагина X; используется для подключений к `localhost`.
`NOTIFY_SOCKET`	Сокет, используемый mysqld для связи с systemd.
`PATH`	Используется оболочкой для поиска программ MySQL.
`PKG_CONFIG_PATH`	Расположение файла pkg-config для `mysqlclient.pc`. См. примечание под таблицей.
`TMPDIR`	Директория, в которой создаются временные файлы.
`TZ`	Должно быть установлено в соответствии с вашим местным часовым поясом. См. Раздел B.3.3.7, «Проблемы с часовыми поясами».
`UMASK`	Режим создания файлов при создании файлов пользователем. См. примечание под таблицей.
`UMASK_DIR`	Режим создания директорий при создании директорий пользователем. См. примечание под таблицей.
`USER`	Имя пользователя по умолчанию в Windows при подключении к mysqld.

Дополнительную информацию о файле истории mysql см. в Разделе 6.5.1.3, «Регистрация клиента mysql».

Использование MYSQL_PWD для указания пароля MySQL следует считать чрезвычайно небезопасным и не должно использоваться. Некоторые версии ps включают опцию для отображения среды запущенных процессов. В некоторых системах, если вы зададите MYSQL_PWD, ваш пароль будет доступен любому другому пользователю, который запустит ps. Даже на системах без такой версии ps не следует полагаться на то, что нет других способов, которыми пользователи могут просматривать среду процессов.

MYSQL_PWD устарел начиная с MySQL 9.2; ожидается его удаление в будущих версиях MySQL.

MYSQL_TEST_LOGIN_FILE — имя файла пути к подключению (файл, созданный mysql_config_editor). Если не задано, значение по умолчанию — %APPDATA%\MySQL\.mylogin.cnf на Windows и $HOME/.mylogin.cnf на не-Windows системах. См. Раздел 6.6.7, «mysql_config_editor — Утилита конфигурации MySQL».

Переменные MYSQL_TEST_TRACE_DEBUG и MYSQL_TEST_TRACE_CRASH управляют плагином отслеживания протокола тестирования клиента, если MySQL скомпилирован с включенным этим плагином. Дополнительную информацию см. в Использование плагина отслеживания протокола тестирования.

Значения по умолчанию для UMASK и UMASK_DIR составляют 0640 и 0750 соответственно. MySQL предполагает, что значение для UMASK или UMASK_DIR находится в восьмеричной системе, если оно начинается с нуля. Например, задание UMASK=0600 эквивалентно UMASK=384, потому что 0600 в восьмеричной системе равно 384 в десятичной.

Переменные UMASK и UMASK_DIR, несмотря на их названия, используются как режимы, а не маски:

Если UMASK задано, mysqld использует ($UMASK | 0600) в качестве режима создания файла, таким образом, недавно созданные файлы имеют режим в диапазоне от 0600 до 0666 (все значения восьмеричные).
Если UMASK_DIR задано, mysqld использует ($UMASK_DIR | 0700) как базовый режим создания директорий, который затем AND-ится с ~(~$UMASK & 0666), таким образом, недавно созданные директории имеют режим в диапазоне от 0700 до 0777 (все значения восьмеричные). Операция AND может удалить права чтения и записи из режима директории, но не права выполнения.

См. также Раздел B.3.3.1, «Проблемы с правами доступа к файлам».

Возможно, потребуется задать PKG_CONFIG_PATH, если вы используете pkg-config для сборки программ MySQL. См. .