MySQL 8.4 發行說明
本節列出 MySQL 直接或間接使用的環境變數。這些變數中的大多數也可以在本手冊的其他地方找到。
命令列上的選項優先於選項檔案和環境變數中指定的值，選項檔案中的值優先於環境變數中的值。在許多情況下，最好使用選項檔案而不是環境變數來修改 MySQL 的行為。請參閱第 6.2.2.2 節，「使用選項檔案」。
| 變數 | 說明 |
|---|---|
AUTHENTICATION_KERBEROS_CLIENT_LOG |
Kerberos 驗證記錄層級。 |
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 驗證外掛程式；請參閱第 8.4.1.4 節，「用戶端明文可插拔驗證」。 |
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_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 socket 檔案名稱；用於連線到 localhost。 |
MYSQLX_TCP_PORT |
X 外掛程式預設的 TCP/IP 連接埠號碼。 |
MYSQLX_UNIX_PORT |
X 外掛程式預設的 Unix socket 檔案名稱；用於連線到 localhost。 |
NOTIFY_SOCKET |
mysqld 用於與 systemd 通訊的 socket。 |
PATH |
shell 用於尋找 MySQL 程式。 |
PKG_CONFIG_PATH |
mysqlclient.pc pkg-config 檔案的位置。請參閱表格後面的註解。 |
TMPDIR |
建立暫存檔的目錄。 |
TZ |
應設定為您的本地時區。請參閱第 B.3.3.7 節，「時區問題」。 |
UMASK |
建立檔案時的使用者檔案建立模式。請參閱表格後面的註解。 |
UMASK_DIR |
建立目錄時的使用者目錄建立模式。請參閱表格後面的註解。 |
USER |
連線到 mysqld 時，Windows 上的預設使用者名稱。 |
有關 mysql 歷史檔案的資訊，請參閱第 6.5.1.3 節，「mysql 用戶端記錄」。
使用 MYSQL_PWD 指定 MySQL 密碼必須被視為極度不安全，不應使用。某些版本的 ps 包含顯示執行中處理程序的環境的選項。在某些系統上，如果設定 MYSQL_PWD，您的密碼將會暴露給任何其他執行 ps 的使用者。即使在沒有此類 ps 版本的系統上，也不宜假設沒有其他方法可以讓使用者檢查處理程序環境。
自 MySQL 8.4 起，已棄用 MYSQL_PWD；預計會在未來的 MySQL 版本中移除。
MYSQL_TEST_LOGIN_FILE 是登入路徑檔案的路徑名稱（該檔案由 mysql_config_editor 所建立）。若未設定，預設值在 Windows 上是 %APPDATA%\MySQL\.mylogin.cnf 目錄，在非 Windows 系統上則是 $HOME/.mylogin.cnf。請參閱 第 6.6.7 節，「mysql_config_editor — MySQL 設定工具」。
若 MySQL 在建置時已啟用測試協定追蹤用戶端外掛程式，MYSQL_TEST_TRACE_DEBUG 和 MYSQL_TEST_TRACE_CRASH 變數會控制該外掛程式。如需更多資訊，請參閱 使用測試協定追蹤外掛程式。
預設的 UMASK 和 UMASK_DIR 值分別為 0640 和 0750。MySQL 假設如果 UMASK 或 UMASK_DIR 的值以零開頭，則該值為八進位。例如，設定 UMASK=0600 等同於 UMASK=384，因為 0600 八進位等於 384 十進位。
儘管 UMASK 和 UMASK_DIR 變數的名稱如此，它們實際上是用作模式，而不是遮罩。
另請參閱 第 B.3.3.1 節，「檔案權限問題」。
如果您使用 pkg-config 來建置 MySQL 程式，可能需要設定 PKG_CONFIG_PATH。請參閱 使用 pkg-config 建置 C API 用戶端程式。