4.9 环境变量

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

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

VariableDescription
AUTHENTICATION_LDAP_CLIENT_LOGClient 端 LDAP 身份验证日志记录级别。
AUTHENTICATION_PAM_LOGPAM身份验证插件调试日志记录设置。
CCC 编译器的名称(用于运行 CMake )。
CXXC 编译器的名称(用于运行 CMake )。
CCC 编译器的名称(用于运行 CMake )。
DBI_USERPerl DBI 的默认用户名。
DBI_TRACEPerl DBI 的跟踪选项。
HOMEmysql历史记录文件的默认路径是$HOME/.mysql_history
LD_RUN_PATH用于指定libmysqlclient.so的位置。
LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN启用mysql_clear_password身份验证插件;参见第 6.4.1.6 节“Client 端明文可插入身份验证”
LIBMYSQL_PLUGIN_DIR在其中查找 Client 端插件的目录。
LIBMYSQL_PLUGINSClient 端插件要预加载。
MYSQL_DEBUG调试时调试跟踪选项。
MYSQL_GROUP_SUFFIX选项组后缀值(如指定--defaults-group-suffix)。
MYSQL_HISTFILEmysql历史记录文件的路径。如果设置了此变量,则其值将覆盖$HOME/.mysql_history的默认值。
MYSQL_HISTIGNORE模式指定mysql不应记录到$HOME/.mysql_historysyslog(如果已提供--syslog)的语句。
MYSQL_HOME服务器特定的my.cnf文件所在的目录的路径。
MYSQL_HOSTmysql命令行 Client 端使用的默认主机名。
MYSQL_OPENSSL_UDF_DH_BITS_THRESHOLDCREATE_DH_PARAMETERS()的最大密钥长度。参见第 12.19.2 节“ MySQL 企业加密的用法和示例”
MYSQL_OPENSSL_UDF_DSA_BITS_THRESHOLDCREATE_ASYMMETRIC_PRIV_KEY()的最大 DSA 密钥长度。参见第 12.19.2 节“ MySQL 企业加密的用法和示例”
MYSQL_OPENSSL_UDF_RSA_BITS_THRESHOLDCREATE_ASYMMETRIC_PRIV_KEY()的最大 RSA 密钥长度。参见第 12.19.2 节“ MySQL 企业加密的用法和示例”
MYSQL_PS1mysql命令行 Client 端中使用的命令提示符。
MYSQL_PWD连接到mysqld时的默认密码。使用此方法是不安全的。参见第 6.1.2.1 节,“最终用户密码安全准则”
MYSQL_TCP_PORT默认的 TCP/IP 端口号。
MYSQL_TEST_LOGIN_FILE.mylogin.cnf登录路径文件的名称。
MYSQL_TEST_TRACE_CRASH测试协议跟踪插件是否会使 Client 端崩溃。请参阅下 table。
MYSQL_TEST_TRACE_DEBUG测试协议跟踪插件是否产生输出。请参阅下 table。
MYSQL_UNIX_PORT缺省的 Unix 套接字文件名;用于连接到localhost
MYSQLX_TCP_PORTX 插件默认的 TCP/IP 端口号。
MYSQLX_UNIX_PORTX Plugin 默认的 Unix 套接字文件名;用于连接到localhost
PATHShell 程序用来查找 MySQL 程序。
PKG_CONFIG_PATHmysqlclient.pc pkg-config 文件的位置。请参阅下 table。
TMPDIR在其中创建临时文件的目录。
TZ应该将其设置为您当地的时区。参见第 B.4.3.7 节“时区问题”
UMASK创建文件时的用户文件创建模式。请参阅下 table。
UMASK_DIR创建目录时的用户目录创建模式。请参阅下 table。
USER连接到mysqld时 Windows 上的默认用户名。

有关mysql历史记录文件的信息,请参见第 4.5.1.3 节“ mysqlClient 端记录”

MYSQL_TEST_LOGIN_FILE是登录路径文件(由mysql_config_editor创建的文件)的路径名。如果未设置,则默认值为 Windows 上的%APPDATA%\MySQL\.mylogin.cnf目录和非 Windows 系统上的$HOME/.mylogin.cnf。参见第 4.6.6 节“ mysql_config_editor-MySQL 配置 Util”

如果 MySQL 是在启用了该插件的情况下构建的,则MYSQL_TEST_TRACE_DEBUGMYSQL_TEST_TRACE_CRASH变量控制测试协议跟踪 Client 端插件。有关更多信息,请参见第 28.2.4.11.1 节,“使用测试协议跟踪插件”

默认的UMASKUMASK_DIR值分别是06400750。 MySQL 假定UMASKUMASK_DIR的值从零开始为八进制。例如,设置UMASK=0600等效于UMASK=384,因为 0600 八进制为 384 十进制。

UMASKUMASK_DIR变量(尽管命名)均用作模式,而不是掩码:

  • 如果设置了UMASK,则mysqld使用($UMASK | 0600)作为文件创建的模式,以便新创建的文件的模式范围为 0600 至 0666(所有值均为八进制)。

  • 如果设置了UMASK_DIR,则mysqld使用($UMASK_DIR | 0700)作为目录创建的基本模式,然后将其与~(~$UMASK & 0666)进行“与”运算,以便新创建的目录的模式范围为 0700 至 0777(所有值均为八进制)。 AND 操作可能会从目录模式中删除读写权限,但不会删除执行权限。

另请参见第 B.4.3.1 节“文件权限问题”

如果您使用 pkg-config 来构建 MySQL 程序,则可能需要设置PKG_CONFIG_PATH。参见第 27.7.3.2 节“使用 pkg-config 构建 C APIClient 端程序”