MySQL :: MySQL 8.4 参考手册 :: 6.9 环境变量

版本 8.4

8.0 日本语

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`	X Plugin 默认 TCP/IP 端口号。
`MYSQLX_UNIX_PORT`	X Plugin 默认 Unix 套接字文件名；用于连接到 `localhost`。
`NOTIFY_SOCKET`	mysqld 用于与 systemd 通信的套接字。
`PATH`	由 shell 用于查找 MySQL 程序。
`PKG_CONFIG_PATH`	`mysqlclient.pc` pkg-config 文件的位置。参见表后的说明。
`TMPDIR`	创建临时文件的目录。
`TZ`	这应该设置为您的本地时区。参见第 B.3.3.7 节，“时区问题”。
`UMASK`	创建文件时的用户文件创建模式。参见表后的说明。
`UMASK_DIR`	创建目录时的用户目录创建模式。参见表后的说明。
`USER`	连接到 mysqld 时的 Windows 上的默认用户名。

有关 mysql 历史文件的信息，参见第 6.5.1.3 节，“mysql 客户端日志记录”。

使用 MYSQL_PWD 指定 MySQL 密码必须被视为 非常不安全，不应该使用。某些版本的 ps 包含一个选项，用于显示正在运行的进程的环境。在某些系统上，如果您设置了 MYSQL_PWD，您的密码将暴露给任何其他运行 ps 的用户。即使在没有此类版本的 ps 的系统上，也不明智地假设没有其他方法可以使用户检查进程环境。

从 MySQL 8.4 开始，MYSQL_PWD 已被弃用；预计在 MySQL 的未来版本中将删除此变量。

MYSQL_TEST_LOGIN_FILE 是登录路径文件的路径名（由 mysql_config_editor 创建的文件）。如果未设置，则 Windows 上的默认值为 %APPDATA%\MySQL\.mylogin.cnf 目录，非 Windows 系统上的默认值为 $HOME/.mylogin.cnf。参见第 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 构建 MySQL 程序，则可能需要设置 PKG_CONFIG_PATH。参见使用 pkg-config 构建 C API 客户端程序.