6.9 Environment Variables — MySQL 8.4

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.4, «Клиентская аутентификация с открытым текстом».
`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 8.4; ожидается его удаление в будущих версиях 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) в качестве базового режима создания каталогов, который затем применяется побитово И с ~(~$UMASK & 0666), чтобы новосозданные каталоги имели режим в диапазоне от 0700 до 0777 (все значения в восьмеричной системе счисления). Операция побитового И может удалить права чтения и записи из режима каталога, но не права выполнения.

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

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