MySQL :: MySQL 9.0 參考手冊 :: 6.9 環境變數

版本 9.0

8.4 目前
8.0
5.7

8.0 日文

6.9 環境變數

本節列出由 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.3 節「用戶端明文可插拔驗證」。
`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 通訊端檔案名稱；用於連線至 `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 時的預設使用者名稱。

如需有關 mysql 歷史記錄檔的資訊，請參閱第 6.5.1.3 節「mysql 用戶端記錄」。

使用 MYSQL_PWD 指定 MySQL 密碼必須被視為極不安全，且不應使用。某些版本的 ps 包含顯示執行中處理程序的環境的選項。在某些系統上，如果您設定 MYSQL_PWD，您的密碼會暴露給任何執行 ps 的其他使用者。即使在沒有此類版本的 ps 的系統上，假設沒有其他使用者可以檢查處理程序環境的方法也是不明智的。

從 MySQL 9.0 開始，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 變數儘管名稱如此，實際上是用作模式而非遮罩。

如果設定了 UMASK，mysqld 會使用 ($UMASK | 0600) 作為檔案建立的模式，以便新建立的檔案具有 0600 到 0666 範圍內的模式（所有值皆為八進位）。
如果設定了 UMASK_DIR，mysqld 會使用 ($UMASK_DIR | 0700) 作為目錄建立的基本模式，然後再與 ~(~$UMASK & 0666) 進行 AND 運算，以便新建立的目錄具有 0700 到 0777 範圍內的模式（所有值皆為八進位）。AND 運算可能會從目錄模式中移除讀取和寫入權限，但不會移除執行權限。

另請參閱第 B.3.3.1 節，〈檔案權限的問題〉。

如果您使用 pkg-config 來建置 MySQL 程式，則可能需要設定 PKG_CONFIG_PATH。請參閱使用 pkg-config 建置 C API 用戶端程式。