4.9 环境变量
本节列出了 MySQL 直接或间接使用的环境变量。这些中的大多数也可以在本手册的其他地方找到。
命令行上的选项优先于选项文件和环境变量中指定的值，而选项文件中的值优先于环境变量中的值。在许多情况下，最好使用选项文件代替环境变量来修改 MySQL 的行为。参见第 4.2.2.2 节“使用选项文件”。
| Variable | Description |
|---|---|
AUTHENTICATION_LDAP_CLIENT_LOG |
Client 端 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 节“Client 端明文可插入身份验证”。 |
LIBMYSQL_PLUGIN_DIR |
在其中查找 Client 端插件的目录。 |
LIBMYSQL_PLUGINS |
Client 端插件要预加载。 |
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命令行 Client 端使用的默认主机名。 |
MYSQL_OPENSSL_UDF_DH_BITS_THRESHOLD |
CREATE_DH_PARAMETERS()的最大密钥长度。参见第 12.19.2 节“ MySQL 企业加密的用法和示例”。 |
MYSQL_OPENSSL_UDF_DSA_BITS_THRESHOLD |
CREATE_ASYMMETRIC_PRIV_KEY()的最大 DSA 密钥长度。参见第 12.19.2 节“ MySQL 企业加密的用法和示例”。 |
MYSQL_OPENSSL_UDF_RSA_BITS_THRESHOLD |
CREATE_ASYMMETRIC_PRIV_KEY()的最大 RSA 密钥长度。参见第 12.19.2 节“ MySQL 企业加密的用法和示例”。 |
MYSQL_PS1 |
在mysql命令行 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_PORT |
X 插件默认的 TCP/IP 端口号。 |
MYSQLX_UNIX_PORT |
X Plugin 默认的 Unix 套接字文件名；用于连接到localhost。 |
PATH |
Shell 程序用来查找 MySQL 程序。 |
PKG_CONFIG_PATH |
mysqlclient.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_DEBUG和MYSQL_TEST_TRACE_CRASH变量控制测试协议跟踪 Client 端插件。有关更多信息，请参见第 28.2.4.11.1 节，“使用测试协议跟踪插件”。
默认的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(所有值均为八进制)。 AND 操作可能会从目录模式中删除读写权限，但不会删除执行权限。
另请参见第 B.4.3.1 节“文件权限问题”。
如果您使用 pkg-config 来构建 MySQL 程序，则可能需要设置PKG_CONFIG_PATH。参见第 27.7.3.2 节“使用 pkg-config 构建 C APIClient 端程序”。