MySQL 8.0 参考手册  / 第 4 章 MySQL 程序  /  4.9 环境变量

4.9 环境变量

本节列出了 MySQL 直接或间接使用的环境变量。其中大部分也可以在本手册的其他地方找到。

命令行上的选项优先于选项文件和环境变量中指定的值，选项文件中的值优先于环境变量中的值。在许多情况下，最好使用选项文件而不是环境变量来修改 MySQL 的行为。请参见 第 4.2.2.2 节，“使用选项文件”。

多变的 描述
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身份验证插件；请参阅第 6.4.1.6 节，“客户端明文可插入身份验证”。
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_OPENSSL_UDF_DH_BITS_THRESHOLD 的最大密钥长度 create_dh_parameters()。请参阅 第 6.6.2 节，“MySQL 企业加密用法和示例”。
MYSQL_OPENSSL_UDF_DSA_BITS_THRESHOLD 的最大 DSA 密钥长度 create_asymmetric_priv_key()。请参阅第 6.6.2 节，“MySQL 企业加密用法和示例”。
MYSQL_OPENSSL_UDF_RSA_BITS_THRESHOLD 的最大 RSA 密钥长度 create_asymmetric_priv_key()。请参阅第 6.6.2 节，“MySQL 企业加密用法和示例”。
MYSQL_PS1 在mysql命令行客户端中使用的命令提示符。
MYSQL_PWD 连接到mysqld时的默认密码。使用它是不安全的。请参阅 第 6.1.2.1 节，“密码安全的最终用户指南”。
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 socket 文件名；用于连接到 localhost.
PATH 由 shell 用来查找 MySQL 程序。
PKG_CONFIG_PATH mysqlclient.pc pkg-config文件的位置。见下表注释。
TMPDIR 创建临时文件的目录。
TZ 这应该设置为您当地的时区。请参阅 第 B.3.3.7 节，“时区问题”。
UMASK 创建文件时的用户文件创建模式。见下表注释。
UMASK_DIR 创建目录时的用户目录创建模式。见下表注释。
USER 连接到mysqld时 Windows 上的默认用户名 。

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

MYSQL_TEST_LOGIN_FILE是登录路径文件（由 mysql_config_editor创建的文件）的路径名。如果未设置，则默认值为%APPDATA%\MySQL\.mylogin.cnfWindows 和$HOME/.mylogin.cnf非 Windows 系统上的目录。请参阅第 4.6.6 节，“mysql_config_editor — MySQL 配置实用程序”。

和变量控制测试协议跟踪客户端插件，如果 MySQL 是在启用该插件的情况下构建的MYSQL_TEST_TRACE_DEBUG。 MYSQL_TEST_TRACE_CRASH有关详细信息，请参阅 使用测试协议跟踪插件。

默认值UMASK和 UMASK_DIR值分别是0640和 0750。UMASK如果or的值UMASK_DIR以零开头，则MySQL 假定它是八进制的。例如，设置 UMASK=0600等同于 UMASK=384因为 0600 八进制是 384 十进制。

TheUMASK和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 程序，则 可能需要进行设置。请参阅 使用 pkg-config 构建 C API 客户端程序。