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

版本 9.0

8.4 当前
8.0
5.7

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.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`	X 插件默认的 TCP/IP 端口号。
`MYSQLX_UNIX_PORT`	X 插件默认的 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`	在 Windows 上连接到 mysqld 时的默认用户名。

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

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

自 MySQL 9.0 起，不推荐使用 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 在构建时启用了测试协议跟踪客户端插件，则变量 MYSQL_TEST_TRACE_DEBUG 和 MYSQL_TEST_TRACE_CRASH 将控制该插件。有关更多信息，请参阅使用测试协议跟踪插件。

默认的 UMASK 和 UMASK_DIR 值分别为 0640 和 0750。如果 UMASK 或 UMASK_DIR 的值以零开头，MySQL 会将其视为八进制数。例如，设置 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 客户端程序。