查看“MySQL环境变量”的源代码


本节列出了MySQL直接或间接使用的环境变量。

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

<br>

{| class="wikitable"
|-
! 变量
! 描述
|-
| AUTHENTICATION_KERBEROS_CLIENT_LOG
| Kerberos认证日志级别。
|-
| AUTHENTICATION_LDAP_CLIENT_LOG
| 客户端侧LDAP认证日志级别。
|-
| AUTHENTICATION_PAM_LOG
| PAM认证插件调试日志设置。
|-
| CC
| 用于运行CMake的C编译器名称。
|-
| CXX
| 用于运行CMake的C++编译器名称。
|-
| CC
| 用于运行CMake的C编译器名称。
|-
| DBI_USER
| Perl DBI的默认用户名。
|-
| DBI_TRACE
| Perl DBI的跟踪选项。
|-
| HOME
| mysql历史文件的默认路径为<math display="inline">HOME/.mysql_history。 | | LD_RUN_PATH | 用于指定libmysqlclient.so.的位置。 | | LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN | 启用mysql_clear_password认证插件。 | | LIBMYSQL_PLUGIN_DIR | 在其中查找客户端插件的目录。 | | LIBMYSQL_PLUGINS | 要预加载的客户端插件。 | | MYSQL_DEBUG | 调试时的跟踪选项。 | | MYSQL_GROUP_SUFFIX | 选项组后缀值（如指定--defaults-group-suffix）。 | | MYSQL_HISTFILE | mysql历史文件的路径。如果此变量设置，其值将覆盖</math>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()的最大密钥长度。
|-
| MYSQL_OPENSSL_UDF_DSA_BITS_THRESHOLD
| create_asymmetric_priv_key()的最大DSA密钥长度。
|-
| MYSQL_OPENSSL_UDF_RSA_BITS_THRESHOLD
| create_asymmetric_priv_key()的最大RSA密钥长度。
|-
| 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时的默认用户名。
|}

<br>

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

从MySQL 8.0开始，MYSQL_PWD已被弃用；预计在未来的MySQL版本中将被移除。

<br>

MYSQL_TEST_LOGIN_FILE是登录路径文件（由mysql_config_editor创建的文件）的路径名。如果未设置，则默认值为Windows上的%APPDATA%.mylogin.cnf目录，非Windows系统上的$HOME/.mylogin.cnf。

<br>

MYSQL_TEST_TRACE_DEBUG和MYSQL_TEST_TRACE_CRASH变量控制测试协议跟踪客户端插件（如果启用了该插件）。有关更多信息，请参阅使用测试协议跟踪插件。

<br>

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

<br>

尽管名称不同，但UMASK和UMASK_DIR变量用作模式，而不是掩码：

* 如果设置了UMASK，mysqld将使用($UMASK | 0600)作为文件创建的模式，以便新创建的文件具有范围在0600到0666（所有值八进制）之间的模式。
* 如果设置了UMASK_DIR，mysqld将使用(<math display="inline">UMASK_DIR | 0700)作为目录创建的基本模式，然后与~(~</math>UMASK &amp; 0666)进行AND操作，以便新创建的目录具有范围在0700到0777（所有值八进制）之间的模式。AND操作可能会从目录模式中删除读取和写入权限，但不能删除执行权限。

<br>

如果您使用pkg-config构建MySQL程序，可能需要设置PKG_CONFIG_PATH。请参阅使用pkg-config构建C API客户端程序。

<br>