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 端程序”。