若要查看伺服器根據其編譯的預設值和它讀取的所有選項檔案使用的值，請使用此命令

mysqld --verbose --help

若要僅查看伺服器根據其編譯的預設值使用的值，忽略任何選項檔案中的設定，請使用此命令

mysqld --no-defaults --verbose --help

若要查看執行中伺服器使用的目前值，請使用 SHOW VARIABLES 陳述式或 Performance Schema 系統變數表格。請參閱第 29.12.14 節，「Performance Schema 系統變數表格」。

第 7.1.9 節，「使用系統變數」，討論了設定和顯示系統變數值的語法。

第 7.1.9.2 節，「動態系統變數」，列出了可以在執行階段設定的變數。

有關調整系統變數的資訊，請參閱第 7.1.1 節，「設定伺服器」。

第 17.14 節，「InnoDB 啟動選項和系統變數」，列出了 InnoDB 系統變數。

第 25.4.3.9.2 節，「NDB 集群系統變數」列出了 NDB 集群特定的系統變數。

關於複製特定的伺服器系統變數資訊，請參閱第 19.1.6 節，「複製和二進制日誌選項與變數」。

activate_all_roles_on_login

是否在使用者登入伺服器時啟用自動啟動所有已授與的角色

已授與的角色包括明確授與使用者的角色和在 mandatory_roles 系統變數值中命名的角色。

activate_all_roles_on_login 僅在登入時，以及在以定義者內容執行的預存程式和檢視的執行開始時適用。若要變更工作階段中的作用中角色，請使用 SET ROLE。若要變更預存程式的作用中角色，程式主體應執行 SET ROLE。

admin_address

要在管理網路介面上接聽 TCP/IP 連線的 IP 位址 (請參閱第 7.1.12.1 節，「連線介面」)。沒有預設的 admin_address 值。如果未在啟動時指定此變數，伺服器將不會維護任何管理介面。伺服器也有一個 bind_address 系統變數，用於設定一般 (非管理) 用戶端 TCP/IP 連線。請參閱第 7.1.12.1 節，「連線介面」。

如果指定 admin_address，則其值必須符合這些要求

IP 位址可以指定為 IPv4 或 IPv6 位址。如果該值是主機名稱，伺服器會將該名稱解析為 IP 位址並繫結至該位址。如果主機名稱解析為多個 IP 位址，伺服器會使用第一個 IPv4 位址 (如果有)，否則會使用第一個 IPv6 位址。

伺服器會如下處理不同類型的位址

這些規則適用於指定位址的網路命名空間

如需有關網路命名空間的其他資訊，請參閱第 7.1.14 節，「網路命名空間支援」。

如果繫結至位址失敗，伺服器會產生錯誤且不會啟動。

admin_address 系統變數類似於將伺服器繫結至一般用戶端連線位址的 bind_address 系統變數，但有以下差異

admin_port

要在管理網路介面上用於連線的 TCP/IP 連接埠號碼 (請參閱第 7.1.12.1 節，「連線介面」)。將此變數設定為 0 會導致使用預設值。

如果未指定 admin_address，則設定 admin_port 無效，因為在這種情況下，伺服器不會維護任何管理網路介面。

admin_ssl_ca

admin_ssl_ca 系統變數類似於 ssl_ca，但它適用於管理連線介面，而不是主連線介面。如需設定管理介面加密支援的相關資訊，請參閱管理介面加密連線支援。

admin_ssl_capath

admin_ssl_capath 系統變數類似於 ssl_capath，但它適用於管理連線介面，而不是主連線介面。如需設定管理介面加密支援的相關資訊，請參閱管理介面加密連線支援。

admin_ssl_cert

admin_ssl_cert 系統變數與 ssl_cert 類似，但它適用於管理連線介面，而非主要連線介面。有關設定管理介面加密支援的資訊，請參閱管理介面的加密連線支援。

admin_ssl_cipher

admin_ssl_cipher 系統變數與 ssl_cipher 類似，但它適用於管理連線介面，而非主要連線介面。有關設定管理介面加密支援的資訊，請參閱管理介面的加密連線支援。

此變數指定的清單可能包含以下任何值

當設定此變數時，嘗試包含未在此處顯示的任何密碼清單中的值會引發錯誤 (ER_BLOCKED_CIPHER)。

admin_ssl_crl

admin_ssl_crl 系統變數與 ssl_crl 類似，但它適用於管理連線介面，而非主要連線介面。有關設定管理介面加密支援的資訊，請參閱管理介面的加密連線支援。

admin_ssl_crlpath

admin_ssl_crlpath 系統變數與 ssl_crlpath 類似，但它適用於管理連線介面，而非主要連線介面。有關設定管理介面加密支援的資訊，請參閱管理介面的加密連線支援。

admin_ssl_key

admin_ssl_key 系統變數與 ssl_key 類似，但它適用於管理連線介面，而非主要連線介面。有關設定管理介面加密支援的資訊，請參閱管理介面的加密連線支援。

admin_tls_ciphersuites

admin_tls_ciphersuites 系統變數與 tls_ciphersuites 類似，但它適用於管理連線介面，而非主要連線介面。有關設定管理介面加密支援的資訊，請參閱管理介面的加密連線支援。

該值是零個或多個以冒號分隔的密碼套件名稱清單，這些名稱來自此處列出的名稱

當設定此變數時，嘗試包含未在此處顯示的任何密碼清單中的值會引發錯誤 (ER_BLOCKED_CIPHER)。

admin_tls_version

admin_tls_version 系統變數與 tls_version 類似，但它適用於管理連線介面，而非主要連線介面。有關設定管理介面加密支援的資訊，請參閱管理介面的加密連線支援。

authentication_policy

此變數用於管理多因素驗證 (MFA) 功能。它適用於 CREATE USER 和 ALTER USER 陳述式的驗證因素相關子句，這些陳述式用於管理 MySQL 帳戶定義，其中「因素」對應於與帳戶關聯的驗證方法或外掛程式

因為 authentication_policy 僅在建立或變更帳戶時適用，因此變更其值對現有使用者帳戶沒有影響。

authentication_policy 的值是以逗號分隔的 1 個、2 個或 3 個元素的清單。每個存在的元素都可以是驗證外掛程式名稱、星號 (*)、空白或遺失。（例外：元素 1 不能為空白或遺失。）在所有情況下，元素可以用空白字元括起來，整個清單用單引號括起來。

為清單中的元素 N 指定的值類型會影響因素 N 是否必須出現在帳戶定義中，以及可以使用哪些驗證外掛程式

當 authentication_policy 元素命名驗證外掛程式時，元素的允許外掛程式名稱受以下條件約束

當 authentication_policy 元素 N 為 * 時，帳戶定義中因素 N 的允許外掛程式名稱受以下條件約束

當 authentication_policy 元素 N 為空時，帳戶定義中因數 N 允許的插件名稱受限於以下條件：

空的元素必須出現在列表的末尾，緊接著非空元素。換句話說，第一個元素不能為空，且要嘛沒有任何元素為空，要嘛最後一個元素為空，要嘛最後兩個元素為空。例如，值 ',,' 不允許，因為它會表示所有因數都是可選的。這是不允許的；帳戶必須至少有一個驗證因數。

authentication_policy 的預設值為 '*,,'。這表示在帳戶定義中因數 1 為必要，且可以使用任何驗證插件，而因數 2 和 3 為可選，且每個可以使用任何不使用內部憑證儲存的驗證插件。

下表顯示一些 authentication_policy 值，以及每個值為建立或變更帳戶所建立的策略。

authentication_windows_log_level

只有在啟用 authentication_windows Windows 驗證插件並啟用偵錯程式碼時，此變數才可用。請參閱第 8.4.1.6 節，「Windows 可插入驗證」。

此變數設定 Windows 驗證插件的記錄層級。下表顯示允許的值。

authentication_windows_use_principal_name

只有在啟用 authentication_windows Windows 驗證插件時，此變數才可用。請參閱第 8.4.1.6 節，「Windows 可插入驗證」。

使用 InitSecurityContext() 函式進行驗證的用戶端應提供一個字串，以識別其連線的服務 (targetName)。MySQL 使用執行伺服器的帳戶主體名稱 (UPN)。UPN 的格式為 user_id@computer_name，且不需要在任何地方註冊即可使用。此 UPN 會由伺服器在驗證交握開始時傳送。

此變數控制伺服器是否在初始質詢中傳送 UPN。依預設，此變數為啟用。基於安全性考量，可以停用此變數，以避免以明文方式將伺服器的帳戶名稱傳送給用戶端。如果停用此變數，伺服器一律會在第一個質詢中傳送 0x00 位元組，用戶端不會指定 targetName，因此會使用 NTLM 驗證。

如果伺服器無法取得其 UPN (這主要發生在不支援 Kerberos 驗證的環境中)，則伺服器不會傳送 UPN，且會使用 NTLM 驗證。

autocommit

自動提交模式。如果設定為 1，對表格的所有變更會立即生效。如果設定為 0，您必須使用 COMMIT 來接受交易，或使用 ROLLBACK 來取消交易。如果 autocommit 為 0 且您將其變更為 1，MySQL 會自動 COMMIT 任何開啟的交易。開始交易的另一種方式是使用 START TRANSACTION 或 BEGIN 陳述式。請參閱第 15.3.1 節，「START TRANSACTION、COMMIT 和 ROLLBACK 陳述式」。

依預設，用戶端連線會以 autocommit 設定為 1 開始。若要使用戶端以預設值 0 開始，請使用 --autocommit=0 選項啟動伺服器，設定全域 autocommit 值。若要使用選項檔設定變數，請包含下列幾行：

[mysqld]
autocommit=0

automatic_sp_privileges

當此變數的值為 1 (預設值) 時，如果使用者還無法執行和變更或捨棄常式，伺服器會自動將 EXECUTE 和 ALTER ROUTINE 權限授與儲存常式的建立者。(捨棄常式需要 ALTER ROUTINE 權限。)當常式捨棄時，伺服器也會自動從建立者中捨棄這些權限。如果 automatic_sp_privileges 為 0，則伺服器不會自動新增或捨棄這些權限。

常式的建立者是執行該常式的 CREATE 陳述式的帳戶。這可能與常式定義中指定為 DEFINER 的帳戶不同。

如果您使用 --skip-new 啟動 mysqld，automatic_sp_privileges 會設定為 OFF。

另請參閱第 27.2.2 節，「儲存常式和 MySQL 權限」。

auto_generate_certs

此變數控制伺服器是否在資料目錄中自動產生 SSL 金鑰和憑證檔案 (如果它們尚不存在)。

在啟動時，如果啟用 auto_generate_certs 系統變數，且資料目錄中缺少伺服器端 SSL 檔案，則伺服器會在資料目錄中自動產生伺服器端和用戶端 SSL 憑證和金鑰檔案。在這些情況下，無論任何其他 TLS 選項的值為何，一律會產生這些憑證。憑證和金鑰檔案可使用 SSL 啟用安全的用戶端連線；請參閱第 8.3.1 節，「設定 MySQL 以使用加密連線」。

如需 SSL 檔案自動產生 (包括檔案名稱和特性) 的詳細資訊，請參閱第 8.3.3.1 節，「使用 MySQL 建立 SSL 和 RSA 憑證和金鑰」

sha256_password_auto_generate_rsa_keys 和 caching_sha2_password_auto_generate_rsa_keys 系統變數是相關的，但會控制透過未加密連線使用 RSA 安全交換密碼所需的 RSA 金鑰配對檔案的自動產生。

back_log

MySQL 可以擁有的未完成連線要求的數目。當主要 MySQL 執行緒在很短的時間內收到大量連線要求時，就會發揮作用。然後，主要執行緒需要一些時間 (雖然非常短) 來檢查連線並啟動新的執行緒。back_log 值會指出在 MySQL 暫時停止回覆新要求之前，在這段短時間內可以堆疊多少要求。只有在您預期在短時間內有大量連線時，才需要增加此值。

換句話說，此值是傳入 TCP/IP 連線的接聽佇列的大小。您的作業系統對此佇列的大小有其限制。《Unix listen() 系統呼叫》的使用手冊頁面應有更多詳細資訊。請檢查您的作業系統文件，以取得此變數的最大值。back_log 的設定值不能高於您的作業系統限制。

預設值為 max_connections 的值，可讓允許的待辦項目調整為允許的最大連線數。

basedir

MySQL 安裝基礎目錄的路徑。

big_tables

如果啟用，伺服器會將所有暫存表格儲存在磁碟上，而不是記憶體中。這會防止大多數需要大型暫存表格的 SELECT 作業發生 表格 tbl_name 已滿 錯誤，但也會減慢記憶體表格足以應付的查詢速度。

新連線的預設值為 OFF（使用記憶體中的暫存表）。正常情況下，永遠不應該啟用此變數。當記憶體中的內部暫存表由 TempTable 儲存引擎（預設）管理，且 TempTable 儲存引擎可佔用的最大記憶體量超出時，TempTable 儲存引擎會開始將資料儲存到磁碟上的暫存檔案。當記憶體中的暫存表由 MEMORY 儲存引擎管理時，記憶體中的表會根據需要自動轉換為基於磁碟的表。如需更多資訊，請參閱第 10.4.4 節「MySQL 中內部暫存表的使用」。

bind_address

MySQL 伺服器會監聽一個或多個網路通訊端以接收 TCP/IP 連線。每個通訊端都會綁定到一個位址，但一個位址有可能對應到多個網路介面。若要指定伺服器應如何監聽 TCP/IP 連線，請在伺服器啟動時設定 bind_address 系統變數。伺服器還有一個 admin_address 系統變數，可在專用介面上啟用管理連線。請參閱第 7.1.12.1 節「連線介面」。

如果指定了 bind_address，則它會接受一個或多個位址值的清單，每個位址值可以指定單一的非萬用字元 IP 位址或主機名稱。每個位址可以包含網路命名空間指定符。如果只指定一個位址，它可以使用允許監聽多個網路介面的其中一種萬用字元位址格式（*、0.0.0.0 或 ::）。多個位址以逗號分隔。當列出多個值時，每個值必須指定單一的非萬用字元 IP 位址（IPv4 或 IPv6）或主機名稱，且不允許使用萬用字元位址格式（*、0.0.0.0 或 ::）。

IP 位址可以指定為 IPv4 或 IPv6 位址。對於任何作為主機名稱的值，伺服器會將名稱解析為 IP 位址並綁定到該位址。如果主機名稱解析為多個 IP 位址，則伺服器會使用第一個 IPv4 位址（如果有的話），否則會使用第一個 IPv6 位址。

伺服器會如下處理不同類型的位址

這些規則適用於指定位址的網路命名空間

如需有關網路命名空間的其他資訊，請參閱第 7.1.14 節，「網路命名空間支援」。

如果綁定到任何位址失敗，伺服器會產生錯誤且不會啟動。

範例

當 bind_address 命名單一值（萬用字元或非萬用字元）時，伺服器會監聽單一通訊端，對於萬用字元位址，該通訊端可能會綁定到多個網路介面。當 bind_address 命名多個值的清單時，伺服器會監聽每個值一個通訊端，每個通訊端綁定到單一網路介面。通訊端數量與指定的值數量呈線性關係。根據作業系統接受連線的效率，冗長的值清單可能會對接受 TCP/IP 連線造成效能上的影響。

由於檔案描述元會配置給監聽通訊端和網路命名空間檔案，因此可能需要增加 open_files_limit 系統變數。

如果您打算將伺服器綁定到特定位址，請確保 mysql.user 系統資料表中包含一個具有管理權限的帳戶，您可以使用該帳戶連線到該位址。否則，您將無法關閉伺服器。例如，如果您將伺服器綁定到 *，則可以使用所有現有帳戶連線到伺服器。但是，如果您將伺服器綁定到 ::1，它只會接受該位址上的連線。在這種情況下，請先確保 'root'@'::1' 帳戶存在於 mysql.user 資料表中，以便您仍然可以連線到伺服器並將其關閉。

block_encryption_mode

此變數控制基於區塊的演算法（例如 AES）的區塊加密模式。它會影響 AES_ENCRYPT() 和 AES_DECRYPT() 的加密。

block_encryption_mode 採用 aes-keylen-mode 格式的值，其中 keylen 是金鑰長度（以位元為單位），mode 是加密模式。值不區分大小寫。允許的 keylen 值為 128、192 和 256。允許的 mode 值為 ECB、CBC、CFB1、CFB8、CFB128 和 OFB。

例如，此語句會導致 AES 加密函式使用 256 位元的金鑰長度和 CBC 模式

SET block_encryption_mode = 'aes-256-cbc';

如果嘗試將 block_encryption_mode 設定為包含不支援的金鑰長度或 SSL 程式庫不支援的模式的值，則會發生錯誤。

build_id

這是由連結器在 Linux 系統上使用 -DWITH_BUILD_ID=ON（預設為啟用）編譯伺服器時產生的 160 位元 SHA1 簽章，並轉換為十六進位字串。此唯讀值用作唯一的組建 ID，並在啟動時寫入伺服器記錄檔中。

除了 Linux 以外的平台不支援 build_id。

bulk_insert_buffer_size

MyISAM 使用特殊的樹狀快取，使將資料新增到非空表時，INSERT ... SELECT、INSERT ... VALUES (...), (...), ... 和 LOAD DATA 的大量插入速度更快。此變數限制每個執行緒快取樹的大小（以位元組為單位）。將其設定為 0 會停用此最佳化。預設值為 8MB。

設定此系統變數的會期值是受限制的操作。會期使用者必須擁有足以設定受限制會期變數的權限。請參閱第 7.1.9.1 節「系統變數權限」。

caching_sha2_password_digest_rounds

caching_sha2_password 驗證外掛程式用於密碼儲存的雜湊回合數。

將雜湊回合數增加到預設值以上會產生效能上的影響，這與增加的量成正比。

caching_sha2_password_auto_generate_rsa_keys

如果資料目錄中尚不存在 RSA 私密/公用金鑰組檔案，伺服器會使用此變數來判斷是否要自動產生這些檔案。

啟動時，如果所有這些條件都為 true，伺服器會自動在資料目錄中產生 RSA 私密/公用金鑰組檔案：sha256_password_auto_generate_rsa_keys 或 caching_sha2_password_auto_generate_rsa_keys 系統變數已啟用；未指定任何 RSA 選項；資料目錄中缺少 RSA 檔案。這些金鑰組檔案可讓透過未加密連線，使用 RSA 安全地交換由 sha256_password（已棄用）或 caching_sha2_password 外掛程式驗證的帳戶密碼；請參閱第 8.4.1.3 節「SHA-256 可插拔驗證」和第 8.4.1.2 節「快取 SHA-2 可插拔驗證」。

如需有關 RSA 檔案自動產生的更多資訊（包括檔案名稱和特性），請參閱第 8.3.3.1 節「使用 MySQL 建立 SSL 和 RSA 憑證和金鑰」

auto_generate_certs 系統變數相關，但它控制使用 SSL 的安全連線所需的 SSL 憑證和金鑰檔案的自動產生。

caching_sha2_password_private_key_path

此變數指定用於 caching_sha2_password 驗證外掛程式的 RSA 私密金鑰檔的路徑名稱。如果檔案名稱為相對路徑，則會相對於伺服器資料目錄來解釋。檔案必須採用 PEM 格式。

有關 caching_sha2_password 的資訊，請參閱第 8.4.1.2 節，「快取 SHA-2 可插拔驗證」。

caching_sha2_password_public_key_path

此變數指定用於 caching_sha2_password 驗證外掛程式的 RSA 公開金鑰檔的路徑名稱。如果檔案名稱為相對路徑，則會相對於伺服器資料目錄來解釋。檔案必須採用 PEM 格式。

有關 caching_sha2_password 的資訊，包括用戶端如何請求 RSA 公開金鑰的資訊，請參閱第 8.4.1.2 節，「快取 SHA-2 可插拔驗證」。

character_set_client

來自用戶端的陳述式所使用的字元集。此變數的工作階段值是在用戶端連線至伺服器時，使用用戶端請求的字元集來設定。(許多用戶端支援 --default-character-set 選項，以允許明確指定此字元集。另請參閱第 12.4 節，「連線字元集和校對」。)當用戶端請求的值未知或不可用，或伺服器設定為忽略用戶端請求時，會使用此變數的全域值來設定工作階段值。當用戶端請求伺服器不知道的字元集時，可能會發生這種情況，例如，當啟用日語的用戶端連線到未設定 sjis 支援的伺服器時，請求 sjis。

某些字元集無法用作用戶端字元集。嘗試將它們用作 character_set_client 值會產生錯誤。請參閱不允許的用戶端字元集。

character_set_connection

用於未指定字元集引導詞的常值和數字到字串轉換的字元集。有關引導詞的資訊，請參閱第 12.3.8 節，「字元集引導詞」。

character_set_database

預設資料庫使用的字元集。每當預設資料庫變更時，伺服器都會設定此變數。如果沒有預設資料庫，則此變數的值與 character_set_server 相同。

設定此系統變數的會期值是受限制的操作。會期使用者必須擁有足以設定受限制會期變數的權限。請參閱第 7.1.9.1 節「系統變數權限」。

全域 character_set_database 和 collation_database 系統變數已過時；預計會在未來版本的 MySQL 中移除它們。

將值指派給工作階段 character_set_database 和 collation_database 系統變數已過時，而且指派會產生警告。預計工作階段變數會在未來版本的 MySQL 中變為唯讀（且對它們的指派會產生錯誤），在該版本中，仍然可以存取工作階段變數以判斷預設資料庫的資料庫字元集和校對。

character_set_filesystem

檔案系統字元集。此變數用於解釋參照檔案名稱的字串常值，例如在 LOAD DATA 和 SELECT ... INTO OUTFILE 陳述式以及 LOAD_FILE() 函數中。在嘗試開啟檔案之前，此類檔案名稱會從 character_set_client 轉換為 character_set_filesystem。預設值為 binary，表示不會發生轉換。對於允許使用多位元組檔案名稱的系統，其他值可能更合適。例如，如果系統使用 UTF-8 表示檔案名稱，請將 character_set_filesystem 設定為 'utf8mb4'。

設定此系統變數的會期值是受限制的操作。會期使用者必須擁有足以設定受限制會期變數的權限。請參閱第 7.1.9.1 節「系統變數權限」。

character_set_results

用於將查詢結果返回給用戶端的字元集。這包括結果資料 (例如資料行值)、結果中繼資料 (例如資料行名稱) 和錯誤訊息。

character_set_server

伺服器的預設字元集。請參閱第 12.15 節，「字元集組態」。如果您設定此變數，則還應設定 collation_server 以指定字元集的校對。

character_set_system

伺服器用於儲存識別碼的字元集。值永遠為 utf8mb3。

character_sets_dir

安裝字元集的目錄。請參閱第 12.15 節，「字元集組態」。

check_proxy_users

某些驗證外掛程式會自行實作用戶端代理使用者對應 (例如，PAM 和 Windows 驗證外掛程式)。其他驗證外掛程式預設不支援代理使用者。在這些外掛程式中，有些可以請求 MySQL 伺服器本身根據授權的代理權限對應代理使用者：mysql_native_password (已過時)、sha256_password (已過時)。

如果啟用 check_proxy_users 系統變數，則伺服器會為發出此類請求的任何驗證外掛程式執行代理使用者對應。但是，可能還需要啟用外掛程式特定的系統變數，才能利用伺服器代理使用者對應支援。

有關使用者代理的資訊，請參閱第 8.2.19 節，「代理使用者」。

collation_connection

連線字元集的校對。collation_connection 對於常值字串的比較很重要。對於字串與資料行值的比較，collation_connection 無關緊要，因為資料行有自己的校對，其校對優先順序較高 (請參閱第 12.8.4 節，「表示式中的校對強制轉換」)。

使用使用者定義的校對名稱作為此變數會引發警告。

collation_database

預設資料庫使用的校對。每當預設資料庫變更時，伺服器都會設定此變數。如果沒有預設資料庫，則此變數的值與 collation_server 相同。

全域 character_set_database 和 collation_database 系統變數已過時；預計會在未來版本的 MySQL 中移除它們。

將值指派給工作階段 character_set_database 和 collation_database 系統變數已過時，而且指派會產生警告。預計工作階段變數會在未來版本的 MySQL 中變為唯讀 (且指派會產生錯誤)，在該版本中，仍然可以存取工作階段變數以判斷預設資料庫的資料庫字元集和校對。

使用使用者定義的校對名稱作為 collation_database 會引發警告。

collation_server

伺服器的預設校對。請參閱第 12.15 節，「字元集設定」。

將此設定為使用者定義校對的名稱會引發警告。

completion_type

交易完成類型。此變數可接受下表顯示的值。可以使用名稱值或對應的整數值來指定變數。

completion_type 會影響以 START TRANSACTION 或 BEGIN 開始，並以 COMMIT 或 ROLLBACK 結束的交易。它不適用於執行第 15.3.3 節，「造成隱含 COMMIT 的陳述式」中列出的陳述式所造成的隱含提交。它也不適用於 XA COMMIT、XA ROLLBACK 或當 autocommit=1 時。

component_scheduler.enabled

在啟動時設定為 OFF 時，背景執行緒不會啟動。仍然可以排程工作，但在啟用 component_scheduler 之前，它們不會執行。在啟動時設定為 ON 時，元件會完全運作。

也可以動態設定值以取得下列效果

concurrent_insert

如果 AUTO (預設值)，MySQL 允許 INSERT 和 SELECT 陳述式對資料檔案中間沒有可用區塊的 MyISAM 表格同時執行。

此變數可接受下表顯示的值。可以使用名稱值或對應的整數值來指定變數。

如果您使用 --skip-new 啟動 mysqld，則 concurrent_insert 會設定為 NEVER。

另請參閱第 10.11.3 節，「並行插入」。

connect_timeout

mysqld 伺服器在回應 Bad handshake 之前等待連線封包的秒數。預設值為 10 秒。

如果用戶端經常遇到 Lost connection to MySQL server at 'XXX', system error: errno 形式的錯誤，則增加 connect_timeout 值可能會有所幫助。

connection_memory_chunk_size

設定全域記憶體使用計數器 Global_connection_memory 更新的區塊大小。只有當所有使用者連線的總記憶體消耗量變動超過此數量時，才會更新狀態變數。透過設定 connection_memory_chunk_size = 0 來停用更新。

記憶體計算不包含系統使用者 (例如 MySQL root 使用者) 使用的任何記憶體。InnoDB 緩衝池使用的記憶體也不包含在內。

您必須擁有 SYSTEM_VARIABLES_ADMIN 或 SUPER 權限才能設定此變數。

connection_memory_limit

設定單一使用者連線可使用的最大記憶體量。如果任何使用者連線使用量超過此數量，則會拒絕來自此連線的所有查詢，並傳回 ER_CONN_LIMIT，包括目前正在執行的任何查詢。

此變數設定的限制不適用於系統使用者，也不適用於 MySQL root 帳戶。InnoDB 緩衝池使用的記憶體也不包含在內。

您必須擁有 SYSTEM_VARIABLES_ADMIN 或 SUPER 權限才能設定此變數。

core_file

如果伺服器意外結束，是否寫入核心檔案。此變數由 --core-file 選項設定。

create_admin_listener_thread

是否在管理網路介面上使用專用的接聽執行緒來處理用戶端連線 (請參閱第 7.1.12.1 節，「連線介面」)。預設值為 OFF；也就是說，主要介面上普通連線的管理員執行緒也會處理管理介面的連線。

根據平台類型和工作負載等因素，您可能會發現此變數的一個設定會產生比另一個設定更好的效能。

如果未指定 admin_address，則設定 create_admin_listener_thread 無效，因為在這種情況下，伺服器不會維護任何管理網路介面。

cte_max_recursion_depth

通用資料表運算式 (CTE) 的最大遞迴深度。伺服器會終止任何遞迴層級超過此變數值的 CTE 的執行。如需詳細資訊，請參閱限制通用資料表運算式遞迴。

datadir

MySQL 伺服器資料目錄的路徑。相對路徑會以目前目錄為基準進行解析。如果您希望伺服器自動啟動 (也就是說，在您無法預先知道目前目錄的情況下)，最好將 datadir 值指定為絕對路徑。

debug

此變數表示目前的偵錯設定。它僅適用於使用偵錯支援建置的伺服器。初始值來自伺服器啟動時給定的 --debug 選項的執行個體值。全域和工作階段值可以在執行階段設定。

設定此系統變數的會期值是受限制的操作。會期使用者必須擁有足以設定受限制會期變數的權限。請參閱第 7.1.9.1 節「系統變數權限」。

指定以 + 或 - 開頭的值會導致該值加入或減去目前值

mysql> SET debug = 'T';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| T       |
+---------+

mysql> SET debug = '+P';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| P:T     |
+---------+

mysql> SET debug = '-P';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| T       |
+---------+

如需詳細資訊，請參閱第 7.9.4 節，「DBUG 套件」。

debug_sync

此變數是 Debug Sync 功能的使用者介面。使用 Debug Sync 需要使用 -DWITH_DEBUG=ON CMake 選項來設定 MySQL (請參閱第 2.8.7 節，「MySQL 來源設定選項」)；否則，此系統變數無法使用。

全域變數值是唯讀的，表示是否已啟用該功能。依預設，Debug Sync 已停用，且 debug_sync 的值為 OFF。如果伺服器啟動時使用 --debug-sync-timeout=N，其中 N 是大於 0 的逾時值，則會啟用 Debug Sync，且 debug_sync 的值為 ON - current signal，後面接著訊號名稱。此外，N 會成為個別同步點的預設逾時。

任何使用者都可以讀取工作階段值，且其值與全域變數相同。可以設定工作階段值來控制同步點。

設定此系統變數的會期值是受限制的操作。會期使用者必須擁有足以設定受限制會期變數的權限。請參閱第 7.1.9.1 節「系統變數權限」。

如需瞭解「除錯同步」功能以及如何使用同步點，請參閱 MySQL 內部構造：測試同步。

default_collation_for_utf8mb4

此變數由伺服器設定為 utf8mb4 字元集的預設排序規則。此變數的值會從來源複製到副本，以便副本能正確處理來自 utf8mb4 具有不同預設排序規則的來源資料。此變數主要用於支援從 MySQL 5.7 或更舊的複製來源伺服器複製到較新的 MySQL 副本伺服器，或是在具有 MySQL 5.7 主節點和一或多個 MySQL 8.0 或更新版本的次要節點的群組複製。在 MySQL 5.7 中，utf8mb4 的預設排序規則為 utf8mb4_general_ci，但在較新的版本系列中為 utf8mb4_0900_ai_ci。此變數在 MySQL 8.0 之前的版本中不存在，因此如果副本未收到此變數的值，它會假設來源來自較舊的版本，並將此值設定為先前的預設排序規則 utf8mb4_general_ci。

下列語句會使用預設的 utf8mb4 排序規則

另請參閱 第 12.9 節「Unicode 支援」。

default_password_lifetime

此變數定義全域自動密碼過期策略。預設的 default_password_lifetime 值為 0，表示停用自動密碼過期。如果 default_password_lifetime 的值為正整數 N，則表示允許的密碼存續期；密碼必須每 N 天變更一次。

可以使用 CREATE USER 和 ALTER USER 語句的密碼過期選項，依需要覆寫個別帳戶的全域密碼過期策略。請參閱 第 8.2.15 節「密碼管理」。

default_storage_engine

表格的預設儲存引擎。請參閱 第 18 章替代儲存引擎。此變數僅設定永久表格的儲存引擎。若要設定 TEMPORARY 表格的儲存引擎，請設定 default_tmp_storage_engine 系統變數。

若要查看哪些儲存引擎可供使用且已啟用，請使用 SHOW ENGINES 語句或查詢 INFORMATION_SCHEMA ENGINES 表格。

如果您在伺服器啟動時停用預設的儲存引擎，則必須將永久和 TEMPORARY 表格的預設引擎都設定為不同的引擎，否則伺服器將不會啟動。

default_table_encryption

定義在建立結構描述和一般表格空間時，未指定 ENCRYPTION 子句的情況下，套用的預設加密設定。

default_table_encryption 變數僅適用於使用者建立的結構描述和一般表格空間。它不控制 mysql 系統表格空間的加密。

設定 default_table_encryption 的執行階段值需要 SYSTEM_VARIABLES_ADMIN 和 TABLE_ENCRYPTION_ADMIN 權限，或已棄用的 SUPER 權限。

default_table_encryption 支援 SET PERSIST 和 SET PERSIST_ONLY 語法。請參閱 第 7.1.9.3 節「持續性系統變數」。

如需更多資訊，請參閱 定義結構描述和一般表格空間的預設加密。

default_tmp_storage_engine

TEMPORARY 表格（使用 CREATE TEMPORARY TABLE 建立）的預設儲存引擎。若要設定永久表格的儲存引擎，請設定 default_storage_engine 系統變數。另請參閱該變數關於可能值的討論。

如果您在伺服器啟動時停用預設的儲存引擎，則必須將永久和 TEMPORARY 表格的預設引擎都設定為不同的引擎，否則伺服器將不會啟動。

default_week_format

用於 WEEK() 函數的預設模式值。請參閱 第 14.7 節「日期和時間函數」。

delay_key_write

此變數指定如何使用延遲索引鍵寫入。它僅適用於 MyISAM 表格。延遲索引鍵寫入會導致索引鍵緩衝區在寫入之間不被清除。另請參閱 第 18.2.1 節「MyISAM 啟動選項」。

此變數可以具有下列其中一個值，以影響在 CREATE TABLE 語句中使用的 DELAY_KEY_WRITE 表格選項的處理方式。

如果為表格啟用 DELAY_KEY_WRITE，則不會在每次索引更新時清除表格的索引鍵緩衝區，而只會在表格關閉時清除。這會大幅加快索引鍵的寫入速度，但如果您使用此功能，則應透過設定 myisam_recover_options 系統變數（例如，myisam_recover_options='BACKUP,FORCE'）啟動伺服器，來新增所有 MyISAM 表格的自動檢查。請參閱 第 7.1.8 節「伺服器系統變數」和 第 18.2.1 節「MyISAM 啟動選項」。

如果您使用 --skip-new 啟動 mysqld，則 delay_key_write 會設定為 OFF。

delayed_insert_limit

此系統變數已棄用（因為不支援 DELAYED 插入），您應該預期它會在未來的版本中被移除。

delayed_insert_timeout

此系統變數已棄用（因為不支援 DELAYED 插入），您應該預期它會在未來的版本中被移除。

delayed_queue_size

此系統變數已棄用（因為不支援 DELAYED 插入），您應該預期它會在未來的版本中被移除。

disabled_storage_engines

此變數表示哪些儲存引擎無法用於建立表格或表格空間。例如，若要防止建立新的 MyISAM 或 FEDERATED 表格，請在伺服器選項檔案中使用下列這些行啟動伺服器

[mysqld]
disabled_storage_engines="MyISAM,FEDERATED"

預設情況下，disabled_storage_engines 為空（未停用任何引擎），但可以將其設定為一或多個引擎的逗號分隔清單（不區分大小寫）。值中命名的任何引擎都無法用於使用 CREATE TABLE 或 CREATE TABLESPACE 建立表格或表格空間，也無法與 ALTER TABLE ... ENGINE 或 ALTER TABLESPACE ... ENGINE 一起使用，以變更現有表格或表格空間的儲存引擎。嘗試這樣做會導致 ER_DISABLED_STORAGE_ENGINE 錯誤。

disabled_storage_engines 不會限制現有資料表的其他 DDL 陳述式，例如 CREATE INDEX、TRUNCATE TABLE、ANALYZE TABLE、DROP TABLE 或 DROP TABLESPACE。這允許平滑轉換，以便可以使用諸如 ALTER TABLE ... ENGINE permitted_engine 的方法，將使用已停用引擎的現有資料表或資料表空間遷移到允許的引擎。

允許將 default_storage_engine 或 default_tmp_storage_engine 系統變數設定為已停用的儲存引擎。這可能會導致應用程式行為異常或失敗，儘管這在開發環境中可能是一種有用的技術，用於識別使用已停用引擎的應用程式，以便可以修改它們。

如果伺服器啟動時使用以下任何選項，則 disabled_storage_engines 會停用且無效：--initialize、--initialize-insecure、--skip-grant-tables。

disconnect_on_expired_password

此變數控制伺服器如何處理密碼過期的用戶端

有關用戶端和伺服器設定之間關於過期密碼處理的互動的更多資訊，請參閱 第 8.2.16 節「伺服器處理過期密碼」。

div_precision_increment

此變數表示使用 / 運算子執行除法運算結果的比例要增加的位數。預設值為 4。最小值和最大值分別為 0 和 30。以下範例說明增加預設值的效果。

mysql> SELECT 1/7;
+--------+
| 1/7    |
+--------+
| 0.1429 |
+--------+
mysql> SET div_precision_increment = 12;
mysql> SELECT 1/7;
+----------------+
| 1/7            |
+----------------+
| 0.142857142857 |
+----------------+

dragnet.log_error_filter_rules

控制 log_filter_dragnet 錯誤記錄篩選器元件運作的篩選規則。如果未安裝 log_filter_dragnet，則 dragnet.log_error_filter_rules 無法使用。如果安裝了 log_filter_dragnet 但未啟用，則對 dragnet.log_error_filter_rules 的變更不會有任何影響。

預設值的效果類似於使用 log_error_verbosity=2 設定的 log_sink_internal 篩選器所執行的篩選。

可以參考 dragnet.Status 狀態變數，以判斷最近一次指派給 dragnet.log_error_filter_rules 的結果。

enterprise_encryption.maximum_rsa_key_size

此變數限制 MySQL Enterprise Encryption 產生的 RSA 金鑰的最大大小。只有在安裝 MySQL Enterprise Encryption 元件 component_enterprise_encryption 時，此變數才可用。

最低設定為 2048 位元，這是目前最佳實務可接受的最低 RSA 金鑰長度。預設設定為 4096 位元。最高設定為 16384 位元。產生較長的金鑰可能會消耗大量的 CPU 資源，因此您可以使用此設定將金鑰限制為可為您的需求提供足夠安全性的長度，同時平衡資源使用率。如需更多資訊，請參閱 第 8.6.2 節「設定 MySQL Enterprise Encryption」。

enterprise_encryption.rsa_support_legacy_padding

此變數控制 MySQL Enterprise Encryption 使用舊的 openssl_udf 共用程式庫函式產生的加密資料和簽章是否可由 MySQL Enterprise Encryption 元件 (component_enterprise_encryption) 解密或驗證。只有在安裝 MySQL Enterprise Encryption 元件時，此變數才可用。

為了讓元件函式支援解密和驗證舊的 openssl_udf 共用程式庫函式所產生的內容，您必須將系統變數填補設定為 ON。當設定為 ON 時，如果元件函式在假設其具有 RSAES-OAEP 或 RSASSA-PSS 配置 (如元件所使用) 時無法解密或驗證內容，則它們會假設其具有 RSAES-PKCS1-v1_5 或 RSASSA-PKCS1-v1_5 配置 (如 openssl_udf 共用程式庫函式所使用) 再次嘗試。當設定為 OFF 時，如果元件函式無法使用其正常配置來解密或驗證內容，它們會傳回 null 輸出。如需更多資訊，請參閱 第 8.6.2 節「設定 MySQL Enterprise Encryption」。

end_markers_in_json

最佳化工具 JSON 輸出是否應加入結束標記。請參閱 MySQL 內部：end_markers_in_json 系統變數。

eq_range_index_dive_limit

此變數表示當最佳化工具應在估計符合條件的資料列數時，從使用索引探測切換到使用索引統計資料時，等式比較條件中的等式範圍數。它適用於評估具有以下任何等效形式的表示式，其中最佳化工具使用非唯一索引來查詢 col_name 值

col_name IN(val1, ..., valN)
col_name = val1 OR ... OR col_name = valN

在這兩種情況下，表示式都包含 N 個等式範圍。最佳化工具可以使用索引探測或索引統計資料來估計資料列。如果 eq_range_index_dive_limit 大於 0，則如果有 eq_range_index_dive_limit 或更多等式範圍，最佳化工具會使用現有的索引統計資料，而不是索引探測。因此，為了允許將索引探測用於最多 N 個等式範圍，請將 eq_range_index_dive_limit 設定為 N + 1。若要停用索引統計資料的使用，並始終使用索引探測，無論 N 為何，請將 eq_range_index_dive_limit 設定為 0。

如需更多資訊，請參閱 多值比較的等式範圍最佳化。

若要更新資料表索引統計資料以獲得最佳估計值，請使用 ANALYZE TABLE。

error_count

產生訊息的最後一個陳述式所導致的錯誤數。此變數為唯讀。請參閱 第 15.7.7.18 節「SHOW ERRORS 陳述式」。

event_scheduler

此變數會啟用或停用事件排程器，並啟動或停止事件排程器。可能狀態值為 ON、OFF 和 DISABLED。將事件排程器設為 OFF 與停用事件排程器不同，停用需要將狀態設定為 DISABLED。在 第 27.4.2 節「事件排程器設定」中更詳細地討論了此變數及其對事件排程器運作的影響

explain_format

此變數決定 EXPLAIN 在顯示查詢執行計畫時，在沒有 FORMAT 選項的情況下所使用的預設輸出格式。此處列出可能的值及其效果

此變數的設定也會影響 EXPLAIN ANALYZE。就此而言，DEFAULT 和 TRADITIONAL 會被解讀為 TREE。如果 explain_format 的值為 JSON，且發出了沒有 FORMAT 選項的 EXPLAIN ANALYZE 語句，該語句會引發錯誤 (ER_NOT_SUPPORTED_YET)。

在 EXPLAIN 或 EXPLAIN ANALYZE 中使用格式指定符會覆蓋 explain_format 的任何設定。

當此語句用於顯示有關表欄位的資訊時，explain_format 系統變數對 EXPLAIN 輸出沒有影響。

設定 explain_format 的 Session 值不需要特殊權限；設定全域層級的值則需要 SYSTEM_VARIABLES_ADMIN (或已棄用的 SUPER 權限)。請參閱第 7.1.9.1 節「系統變數權限」。

如需更多資訊和範例，請參閱取得執行計畫資訊。

explain_json_format_version

決定 EXPLAIN FORMAT=JSON 語句使用的 JSON 輸出格式的版本。將此變數設定為 1 會導致伺服器使用版本 1，這是較舊版本的 MySQL 中用於此類語句輸出的線性格式；這是 MySQL 8.4 中的預設值。將 explain_json_format_version 設定為 2 會導致使用版本 2 格式；此 JSON 輸出格式基於存取路徑，旨在提供與未來版本的 MySQL Optimizer 更好的相容性。

如需使用範例，請參閱取得執行計畫資訊。

explicit_defaults_for_timestamp

此系統變數決定伺服器是否啟用 TIMESTAMP 欄位中預設值和 NULL 值處理的某些非標準行為。預設情況下，explicit_defaults_for_timestamp 處於啟用狀態，這會停用非標準行為。停用 explicit_defaults_for_timestamp 會導致警告。

如果停用 explicit_defaults_for_timestamp，伺服器會啟用非標準行為並按照以下方式處理 TIMESTAMP 欄位：

剛才描述的非標準行為已被棄用；預期它們將在未來的 MySQL 版本中移除。

如果啟用 explicit_defaults_for_timestamp，伺服器會停用非標準行為並按照以下方式處理 TIMESTAMP 欄位：

如果在伺服器啟動時停用 explicit_defaults_for_timestamp，則錯誤記錄中會出現此警告：

[Warning] TIMESTAMP with implicit DEFAULT value is deprecated.
Please use --explicit_defaults_for_timestamp server option (see
documentation for more details).

如警告所示，若要停用已棄用的非標準行為，請在伺服器啟動時啟用 explicit_defaults_for_timestamp 系統變數。

如需其他資訊，請參閱第 13.2.5 節「TIMESTAMP 和 DATETIME 的自動初始化和更新」。

external_user

在驗證過程中使用的外部使用者名稱，由用於驗證用戶端的插件設定。使用原生（內建）MySQL 驗證，或如果插件未設定該值，此變數為 NULL。請參閱第 8.2.19 節「Proxy Users」。

flush

如果為 ON，伺服器會在每個 SQL 語句後將所有變更刷新（同步）到磁碟。通常，MySQL 只會在每個 SQL 語句後將所有變更寫入磁碟，並讓作業系統處理與磁碟的同步。請參閱第 B.3.3.3 節「如果 MySQL 持續崩潰該怎麼辦」。如果使用 --flush 選項啟動 mysqld，則此變數會設為 ON。

flush_time

如果設定為非零值，則每隔 flush_time 秒會關閉所有表格，以釋放資源並將未刷新的資料同步到磁碟。此選項最好僅用於資源最少的系統。

foreign_key_checks

如果設定為 1 (預設值)，則會檢查外鍵約束。如果設定為 0，則會忽略外鍵約束，但有幾個例外。重新建立已刪除的表格時，如果表格定義不符合參照該表格的外鍵約束，則會傳回錯誤。同樣地，如果外鍵定義的格式不正確，ALTER TABLE 操作會傳回錯誤。如需詳細資訊，請參閱第 15.1.20.5 節「FOREIGN KEY 約束」。

將此變數設定為 NDB 表格的效果與對 InnoDB 表格的效果相同。通常您會在正常操作期間啟用此設定，以強制執行參考完整性。停用外鍵檢查對於以不同於其父/子關係所要求的順序重新載入 InnoDB 表格可能很有用。請參閱第 15.1.20.5 節「FOREIGN KEY 約束」。

將 foreign_key_checks 設定為 0 也會影響資料定義語句：DROP SCHEMA 會刪除綱要，即使它包含具有外部綱要表格參照的外鍵的表格，並且 DROP TABLE 會刪除具有其他表格參照的外鍵的表格。

ft_boolean_syntax

使用 IN BOOLEAN MODE 執行的布林全文檢索搜尋支援的運算子清單。請參閱第 14.9.2 節「布林全文檢索搜尋」。

預設變數值為 '+ -><()~*:""&|'。變更值的規則如下

ft_max_word_len

要包含在 MyISAM FULLTEXT 索引中的最大單字長度。

ft_min_word_len

要包含在 MyISAM FULLTEXT 索引中的最小單字長度。

ft_query_expansion_limit

要用於使用 WITH QUERY EXPANSION 執行的全文檢索搜尋的頂端相符項目數量。

ft_stopword_file

要從中讀取 MyISAM 表格全文檢索搜尋的停用字清單的檔案。伺服器會在資料目錄中尋找檔案，除非給定絕對路徑名稱來指定不同的目錄。使用檔案中的所有單字；不接受註解。預設情況下，會使用內建的停用字清單（如 storage/myisam/ft_static.c 檔案中所定義）。將此變數設定為空字串 ('') 會停用停用字篩選。另請參閱第 14.9.4 節「全文檢索停用字」。

general_log

是否啟用一般查詢記錄。值可以是 0（或 OFF）以停用記錄，或 1（或 ON）以啟用記錄。記錄輸出的目的地由 log_output 系統變數控制；如果該值為 NONE，即使啟用記錄，也不會寫入任何記錄項目。

general_log_file

一般查詢記錄檔的名稱。預設值為 host_name.log，但可以使用 --general_log_file 選項變更初始值。

generated_random_password_length

為 CREATE USER、ALTER USER 和 SET PASSWORD 語句產生的隨機密碼中允許的最大字元數。如需詳細資訊，請參閱隨機密碼產生。

global_connection_memory_limit

設定所有使用者連線可使用的總記憶體量；也就是說，Global_connection_memory 不應超過此量。任何時候超過此量，都會以 ER_GLOBAL_CONN_LIMIT 拒絕所有來自一般使用者的查詢（包括任何目前正在執行的查詢）。

系統使用者（例如 MySQL root 使用者）使用的記憶體會包含在此總數中，但不計入中斷連線限制；此類使用者永遠不會因記憶體使用量而中斷連線。

從總數中排除 InnoDB 緩衝池使用的記憶體。

您必須擁有 SYSTEM_VARIABLES_ADMIN 或 SUPER 權限才能設定此變數。

global_connection_memory_tracking

決定伺服器是否計算 Global_connection_memory。必須明確啟用此變數；否則，不會執行記憶體計算，且不會設定 Global_connection_memory。

您必須擁有 SYSTEM_VARIABLES_ADMIN 或 SUPER 權限才能設定此變數。

group_concat_max_len

GROUP_CONCAT() 函數允許的最大結果長度（以位元組為單位）。預設值為 1024。

have_compress

如果伺服器可以使用 zlib 壓縮函式庫，則為 YES，否則為 NO。如果為否，則無法使用 COMPRESS() 和 UNCOMPRESS() 函式。

have_dynamic_loading

如果 mysqld 支援外掛程式的動態載入，則為 YES，否則為 NO。如果值為 NO，則無法使用諸如 --plugin-load 等選項在伺服器啟動時載入外掛程式，或使用 INSTALL PLUGIN 陳述式在執行時載入外掛程式。

have_geometry

如果伺服器支援空間資料類型，則為 YES，否則為 NO。

have_profiling

如果存在陳述式效能分析功能，則為 YES，否則為 NO。如果存在，profiling 系統變數會控制此功能是否啟用或停用。請參閱 第 15.7.7.32 節，「SHOW PROFILES 陳述式」。

此變數已棄用；您應該預期它會在未來的 MySQL 版本中移除。

have_query_cache

have_query_cache 已棄用，永遠具有 NO 的值，您應該預期它會在未來的 MySQL 版本中移除。

have_rtree_keys

如果可以使用 RTREE 索引，則為 YES，否則為 NO。（這些用於 MyISAM 表格中的空間索引。）

have_statement_timeout

陳述式執行逾時功能是否可用（請參閱 陳述式執行時間最佳化提示）。如果此功能使用的背景執行緒無法初始化，則值可能為 NO。

have_symlink

如果啟用符號連結支援，則為 YES，否則為 NO。在 Unix 上，這是支援 DATA DIRECTORY 和 INDEX DIRECTORY 表格選項所必需的。如果伺服器啟動時使用 --skip-symbolic-links 選項，則值為 DISABLED。

此變數在 Windows 上沒有意義。

histogram_generation_max_mem_size

產生直方圖統計資料可用的最大記憶體量。請參閱 第 10.9.6 節，「最佳化工具統計資料」和 第 15.7.3.1 節，「ANALYZE TABLE 陳述式」。

設定此系統變數的會期值是受限制的操作。會期使用者必須擁有足以設定受限制會期變數的權限。請參閱第 7.1.9.1 節「系統變數權限」。

host_cache_size

MySQL 伺服器維護一個記憶體中的主機快取，其中包含用戶端主機名稱和 IP 位址資訊，並用於避免網域名稱系統 (DNS) 查閱；請參閱 第 7.1.12.3 節，「DNS 查閱和主機快取」。

host_cache_size 變數會控制主機快取的大小，以及公開快取內容的 Performance Schema host_cache 表格的大小。設定 host_cache_size 具有以下效果：

預設值會自動調整為 128，加上 max_connections 值高達 500 的值加 1，加上 max_connections 值超過 500 時，每遞增 20 就加 1，上限為 2000。

hostname

伺服器會在啟動時將此變數設定為伺服器主機名稱。最大長度為 255 個字元。

identity

此變數是 last_insert_id 變數的同義詞。它的存在是為了與其他資料庫系統相容。您可以使用 SELECT @@identity 讀取其值，並使用 SET identity 設定它。

init_connect

伺服器為每個連線的用戶端執行的字串。此字串由一個或多個 SQL 陳述式組成，並以分號字元分隔。

對於具有 CONNECTION_ADMIN 權限（或已棄用的 SUPER 權限）的使用者，不會執行 init_connect 的內容。這樣做的目的是為了防止 init_connect 的錯誤值阻止所有用戶端連線。例如，此值可能包含語法錯誤的陳述式，從而導致用戶端連線失敗。不為具有 CONNECTION_ADMIN 或 SUPER 權限的使用者執行 init_connect，可讓他們開啟連線並修正 init_connect 的值。

對於任何密碼已過期的用戶端使用者，會跳過 init_connect 的執行。這樣做是因為此類使用者無法執行任意陳述式，因此 init_connect 的執行會失敗，導致用戶端無法連線。跳過 init_connect 的執行可讓使用者連線並變更密碼。

伺服器會捨棄 init_connect 值中陳述式產生的任何結果集。

information_schema_stats_expiry

某些 INFORMATION_SCHEMA 表格包含提供表格統計資料的欄位。

STATISTICS.CARDINALITY
TABLES.AUTO_INCREMENT
TABLES.AVG_ROW_LENGTH
TABLES.CHECKSUM
TABLES.CHECK_TIME
TABLES.CREATE_TIME
TABLES.DATA_FREE
TABLES.DATA_LENGTH
TABLES.INDEX_LENGTH
TABLES.MAX_DATA_LENGTH
TABLES.TABLE_ROWS
TABLES.UPDATE_TIME

這些欄位代表動態表格中繼資料；也就是說，隨著表格內容變更而變更的資訊。

預設情況下，當查詢這些欄位時，MySQL 會從 mysql.index_stats 和 mysql.table_stats 字典表格中擷取這些欄位的快取值，這比直接從儲存引擎擷取統計資料更有效率。如果快取統計資料不可用或已過期，MySQL 會從儲存引擎擷取最新的統計資料，並將其快取在 mysql.index_stats 和 mysql.table_stats 字典表格中。後續查詢會擷取快取的統計資料，直到快取的統計資料過期。伺服器重新啟動或第一次開啟 mysql.index_stats 和 mysql.table_stats 表格不會自動更新快取的統計資料。

information_schema_stats_expiry 工作階段變數定義快取的統計資料過期前的時間長度。預設值為 86400 秒（24 小時），但時間長度可以延長至最多一年。

若要隨時更新給定表格的快取值，請使用 ANALYZE TABLE。

若要始終直接從儲存引擎擷取最新的統計資料並略過快取值，請將 information_schema_stats_expiry 設定為 0。

在以下情況下，查詢統計資料欄位不會在 mysql.index_stats 和 mysql.table_stats 字典表格中儲存或更新統計資料：

統計資料快取可能會在多語句交易期間更新，在已知交易是否提交之前。因此，快取可能包含與已知已提交狀態不符的資訊。這可能會在 autocommit=0 或在 START TRANSACTION 之後發生。

information_schema_stats_expiry 是一個會話變數，每個用戶端會話都可以定義自己的到期值。從儲存引擎檢索並由一個會話快取的統計資料可供其他會話使用。

相關資訊，請參閱 第 10.2.3 節，「最佳化 INFORMATION_SCHEMA 查詢」。

init_file

如果指定此變數，則此變數會命名一個包含 SQL 陳述式的檔案，這些陳述式將在啟動過程中讀取和執行。此檔案中陳述式的可接受格式支援以下結構

如果伺服器使用 --initialize 或 --initialize-insecure 選項啟動，則它會在引導模式下運作，並且某些功能不可用，這會限制檔案中允許的陳述式。這些包括與帳戶管理相關的陳述式（例如 CREATE USER 或 GRANT）、複製和全域交易識別碼。請參閱 第 19.1.3 節，「使用全域交易識別碼進行複製」。

伺服器啟動期間建立的執行緒用於執行諸如建立資料字典、執行升級程序和建立系統表格等任務。為了確保穩定且可預測的環境，這些執行緒會使用伺服器內建的預設值來執行某些系統變數，例如 sql_mode、 character_set_server、 collation_server、 completion_type、 explicit_defaults_for_timestamp 和 default_table_encryption。

這些執行緒也用於執行使用 init_file 指定的任何檔案中的陳述式，當啟動伺服器時，因此這些陳述式會使用伺服器內建的預設值來執行這些系統變數。

innodb_xxx

InnoDB 系統變數列在 第 17.14 節，「InnoDB 啟動選項和系統變數」中。這些變數控制 InnoDB 表格的儲存、記憶體使用和 I/O 模式的許多方面，並且現在 InnoDB 是預設儲存引擎，因此尤其重要。

insert_id

當插入 AUTO_INCREMENT 值時，以下 INSERT 或 ALTER TABLE 陳述式要使用的值。這主要與二進位日誌一起使用。

interactive_timeout

伺服器在關閉互動連線之前等待活動的秒數。互動式用戶端定義為使用 CLIENT_INTERACTIVE 選項到 mysql_real_connect() 的用戶端。另請參閱 wait_timeout。

internal_tmp_mem_storage_engine

用於記憶體內部暫存表格的儲存引擎（請參閱 第 10.4.4 節，「MySQL 中內部暫存表格的使用」）。允許的值為 TempTable（預設值）和 MEMORY。

最佳化器會使用 internal_tmp_mem_storage_engine 定義的儲存引擎來用於記憶體內部暫存表格。

設定 internal_tmp_mem_storage_engine 的會話設定需要 SESSION_VARIABLES_ADMIN 或 SYSTEM_VARIABLES_ADMIN 權限。

join_buffer_size

用於純索引掃描、範圍索引掃描和不使用索引並因此執行完整表格掃描的聯結的緩衝區的最小大小。此變數也控制雜湊聯結使用的記憶體量。通常，獲得快速聯結的最佳方法是新增索引。當無法新增索引時，請增加 join_buffer_size 的值以獲得更快的完整聯結。在兩個表格之間的每個完整聯結都會分配一個聯結緩衝區。對於不使用索引的多個表格之間的複雜聯結，可能需要多個聯結緩衝區。

預設值為 256KB。 join_buffer_size 的最大允許設定為 4GB−1。允許 64 位元平台使用較大的值（64 位元 Windows 除外，其中較大的值會截斷為 4GB−1 並發出警告）。區塊大小為 128，且 MySQL 伺服器在儲存系統變數的值之前，會將不是區塊大小確切倍數的值向下捨入到區塊大小的下一個較小的倍數。剖析器允許值高達平台的最大不帶正負號的整數值（對於 32 位元系統，為 4294967295 或 2³²−1，對於 64 位元系統，為 18446744073709551615 或 2⁶⁴−1），但實際最大值是較低的區塊大小。

除非使用區塊巢狀迴圈或批次金鑰存取演算法，否則設定大於容納每個相符列所需的緩衝區不會有任何增益，並且所有聯結至少會分配最小大小，因此請謹慎地將此變數全域設定為較大的值。最好將全域設定保持較小，並且僅在執行大型聯結的會話中將會話設定變更為較大的值，或者使用 SET_VAR 最佳化器提示，根據每個查詢變更設定（請參閱 第 10.9.3 節，「最佳化器提示」）。如果全域大小大於使用它的多數查詢所需的大小，則記憶體配置時間可能會導致效能大幅下降。

當使用區塊巢狀迴圈時，較大的聯結緩衝區可能會有好處，直到將第一個表格中所有列的所有必要欄都儲存在聯結緩衝區中。這取決於查詢；最佳大小可能小於容納第一個表格的所有列。

當使用批次金鑰存取時，join_buffer_size 的值會定義每個儲存引擎請求中金鑰批次的大小。緩衝區越大，對聯結操作的右手表格的循序存取越多，這可以顯著提高效能。

有關聯結緩衝的更多資訊，請參閱 第 10.2.1.7 節，「巢狀迴圈聯結演算法」。有關批次金鑰存取的資訊，請參閱 第 10.2.1.12 節，「區塊巢狀迴圈和批次金鑰存取聯結」。有關雜湊聯結的資訊，請參閱 第 10.2.1.4 節，「雜湊聯結最佳化」。

keep_files_on_create

如果建立沒有 DATA DIRECTORY 選項的 MyISAM 表格，則會在資料庫目錄中建立 .MYD 檔案。預設情況下，如果 MyISAM 在這種情況下找到現有的 .MYD 檔案，它會覆寫它。對於使用沒有 INDEX DIRECTORY 選項建立的表格的 .MYI 檔案也是如此。若要抑制此行為，請將 keep_files_on_create 變數設定為 ON (1)，在這種情況下，MyISAM 不會覆寫現有檔案，而是會傳回錯誤。預設值為 OFF (0)。

如果使用 DATA DIRECTORY 或 INDEX DIRECTORY 選項建立 MyISAM 表格，並且找到現有的 .MYD 或 .MYI 檔案，MyISAM 總是會返回錯誤。它不會覆寫指定目錄中的檔案。

key_buffer_size

MyISAM 表格的索引區塊會被緩衝，並由所有執行緒共用。key_buffer_size 是用於索引區塊的緩衝區大小。金鑰緩衝區也稱為金鑰快取。

最小允許設定值為 0，但您無法動態將 key_buffer_size 設定為 0。設定為 0 會捨棄金鑰快取，這在執行階段是不允許的。僅在啟動時才允許將 key_buffer_size 設定為 0，在這種情況下，金鑰快取不會初始化。在執行階段將 key_buffer_size 設定從值 0 變更為允許的非零值會初始化金鑰快取。

key_buffer_size 只能以 4096 位元組的增量或倍數增加或減少。以不符合規定的值增加或減少設定會產生警告，並將設定截斷為符合規定的值。

key_buffer_size 在 32 位元平台上最大允許設定為 4GB-1。對於 64 位元平台，允許更大的值。有效最大大小可能會較小，具體取決於您可用的實體 RAM 和作業系統或硬體平台施加的每個處理程序 RAM 限制。此變數的值表示請求的記憶體量。在內部，伺服器會盡可能分配最多到此數量的記憶體，但實際分配量可能較少。

您可以增加此值，以改善所有讀取和多次寫入的索引處理；在主要功能是使用 MyISAM 儲存引擎執行 MySQL 的系統上，機器總記憶體的 25% 是此變數的可接受值。但是，您應該注意，如果將該值設定得太大（例如，超過機器總記憶體的 50%），您的系統可能會開始分頁並變得極慢。這是因為 MySQL 依賴作業系統來執行資料讀取的文件系統快取，因此您必須為文件系統快取保留一些空間。您還應該考慮您可能使用的任何其他儲存引擎（除了 MyISAM 之外）的記憶體需求。

為了在同時寫入多行時獲得更快的速度，請使用 LOCK TABLES。請參閱第 10.2.5.1 節，「最佳化 INSERT 陳述式」。

您可以發出 SHOW STATUS 陳述式並檢查 Key_read_requests、Key_reads、Key_write_requests 和 Key_writes 狀態變數來檢查金鑰緩衝區的效能。（請參閱第 15.7.7 節，「SHOW 陳述式」。）Key_reads/Key_read_requests 比率通常應小於 0.01。Key_writes/Key_write_requests 比率通常接近 1，如果您主要使用更新和刪除，但如果您傾向於同時執行影響多行的更新，或如果您使用 DELAY_KEY_WRITE 表格選項，則可能小得多。

可以使用 key_buffer_size 以及 Key_blocks_unused 狀態變數和緩衝區區塊大小（可從 key_cache_block_size 系統變數取得）來判斷金鑰緩衝區的使用比例。

1 - ((Key_blocks_unused * key_cache_block_size) / key_buffer_size)

此值為近似值，因為金鑰緩衝區中的某些空間會被內部配置用於管理結構。影響這些結構的額外負荷量的因素包括區塊大小和指標大小。隨著區塊大小的增加，金鑰緩衝區因額外負荷而損失的百分比趨於減少。較大的區塊會導致較少的讀取操作次數（因為每次讀取會取得更多金鑰），但反過來會增加讀取未檢查的金鑰次數（如果區塊中的所有金鑰都與查詢無關）。

可以建立多個 MyISAM 金鑰快取。4GB 的大小限制適用於每個快取，而不是群組。請參閱第 10.10.2 節，「MyISAM 金鑰快取」。

key_cache_age_threshold

此值控制緩衝區從金鑰快取的熱子清單降級到暖子清單。較低的值會導致更快地發生降級。最小值為 100。預設值為 300。請參閱第 10.10.2 節，「MyISAM 金鑰快取」。

key_cache_block_size

金鑰快取中區塊的大小（以位元組為單位）。預設值為 1024。請參閱第 10.10.2 節，「MyISAM 金鑰快取」。

key_cache_division_limit

金鑰快取緩衝區清單的熱子清單和暖子清單之間的分隔點。該值是要用於暖子清單的緩衝區清單的百分比。允許的值範圍為 1 到 100。預設值為 100。請參閱第 10.10.2 節，「MyISAM 金鑰快取」。

large_files_support

是否已使用大型檔案支援的選項編譯 mysqld。

large_pages

是否已啟用大型頁面支援（透過 --large-pages 選項）。請參閱第 10.12.3.3 節，「啟用大型頁面支援」。

large_page_size

如果啟用大型頁面支援，則會顯示記憶體頁面的大小。大型記憶體頁面僅在 Linux 上受支援；在其他平台上，此變數的值始終為 0。請參閱第 10.12.3.3 節，「啟用大型頁面支援」。

last_insert_id

要從 LAST_INSERT_ID() 返回的值。當您在更新表格的陳述式中使用 LAST_INSERT_ID() 時，此值會儲存在二進位記錄中。設定此變數不會更新 mysql_insert_id() C API 函式所返回的值。

lc_messages

用於錯誤訊息的語言環境。預設值為 en_US。伺服器會將引數轉換為語言名稱，並將其與 lc_messages_dir 的值組合，以產生錯誤訊息檔案的位置。請參閱第 12.12 節，「設定錯誤訊息語言」。

lc_messages_dir

錯誤訊息所在的目錄。伺服器會將該值與 lc_messages 的值一起使用，以產生錯誤訊息檔案的位置。請參閱第 12.12 節，「設定錯誤訊息語言」。

lc_time_names

此變數指定控制顯示日期和月份名稱及縮寫的語言環境。此變數會影響 DATE_FORMAT()、 DAYNAME() 和 MONTHNAME() 函數的輸出。語言環境名稱是 POSIX 樣式的值，例如 'ja_JP' 或 'pt_BR'。預設值為 'en_US'，無論您的系統語言環境設定為何。如需更多資訊，請參閱 第 12.16 節，「MySQL 伺服器語言環境支援」。

license

伺服器擁有的授權類型。

local_infile

此變數控制伺服器端的 LOCAL 功能，用於 LOAD DATA 陳述式。根據 local_infile 設定，伺服器會拒絕或允許用戶端載入本機資料，而用戶端在用戶端端已啟用 LOCAL。

若要明確讓伺服器拒絕或允許 LOAD DATA LOCAL 陳述式（無論用戶端程式和程式庫在建置時或執行時如何設定），請分別以停用或啟用 local_infile 的方式啟動 mysqld。local_infile 也可以在執行時設定。如需更多資訊，請參閱 第 8.1.6 節，「LOAD DATA LOCAL 的安全性考量」。

lock_wait_timeout

此變數指定嘗試取得中繼資料鎖定的逾時時間（以秒為單位）。允許的值範圍為 1 到 31536000（1 年）。預設值為 31536000。

此逾時時間適用於所有使用中繼資料鎖定的陳述式。這些包括資料表、檢視、預存程序和預存函數上的 DML 和 DDL 作業，以及 LOCK TABLES、 FLUSH TABLES WITH READ LOCK 和 HANDLER 陳述式。

此逾時時間不適用於 mysql 資料庫中系統資料表的隱含存取，例如 GRANT 或 REVOKE 陳述式修改的授權資料表，或資料表記錄陳述式。此逾時時間適用於直接存取的系統資料表，例如使用 SELECT 或 UPDATE。

逾時值會分別適用於每次中繼資料鎖定嘗試。給定的陳述式可能需要一個以上的鎖定，因此陳述式可能會在回報逾時錯誤之前，封鎖的時間長於 lock_wait_timeout 值。發生鎖定逾時時，會回報 ER_LOCK_WAIT_TIMEOUT。

lock_wait_timeout 也定義 LOCK INSTANCE FOR BACKUP 陳述式在放棄之前等待鎖定的時間量。

locked_in_memory

mysqld 是否以 --memlock 鎖定在記憶體中。

log_error

預設錯誤記錄目的地。如果目的地是主控台，則值為 stderr。否則，目的地是檔案，且 log_error 值為檔案名稱。請參閱 第 7.4.2 節，「錯誤記錄」。

log_error_services

要為錯誤記錄啟用的元件。變數可能包含 0、1 或多個元素的清單。在後一種情況下，元素可能會以分號或逗號分隔，並可選擇性地接上空格。給定的設定無法同時使用分號和逗號分隔符號。元件順序很重要，因為伺服器會依列出的順序執行元件。

如果在 log_error_services 中命名的任何可載入 (非內建) 元件尚未載入，則會隱含載入。如需更多資訊，請參閱 第 7.4.2.1 節，「錯誤記錄設定」。

log_error_suppression_list

log_error_suppression_list 系統變數適用於預定用於錯誤記錄的事件，並指定當事件發生且優先順序為 WARNING 或 INFORMATION 時要隱藏的事件。例如，如果特定類型的警告被視為錯誤記錄中不必要的「雜訊」，因為它發生頻繁但沒有意義，則可以隱藏它。此變數會影響預設啟用的 log_filter_internal 錯誤記錄篩選器元件所執行的篩選（請參閱 第 7.5.3 節，「錯誤記錄元件」）。如果停用 log_filter_internal，log_error_suppression_list 則不會有任何作用。

log_error_suppression_list 值可能為空字串表示不隱藏，或一個或多個以逗號分隔的值清單，指示要隱藏的錯誤碼。錯誤碼可以用符號或數值形式指定。可以用或不用 MY- 前置詞指定數值碼。數值部分的前導零並不重要。允許的程式碼格式範例如下

ER_SERVER_SHUTDOWN_COMPLETE
MY-000031
000031
MY-31
31

符號值比數值更容易閱讀和攜帶，因此建議使用符號值。如需有關允許的錯誤符號和數字的資訊，請參閱 MySQL 8.4 錯誤訊息參考。

log_error_suppression_list 的效果會與 log_error_verbosity 的效果結合。如需更多資訊，請參閱 第 7.4.2.5 節，「基於優先順序的錯誤記錄篩選 (log_filter_internal)」。

log_error_verbosity

log_error_verbosity 系統變數指定用於處理預定用於錯誤記錄之事件的詳細程度。此變數會影響預設啟用的 log_filter_internal 錯誤記錄篩選器元件所執行的篩選（請參閱 第 7.5.3 節，「錯誤記錄元件」）。如果停用 log_filter_internal，log_error_verbosity 則不會有任何作用。

預定用於錯誤記錄的事件具有 ERROR、 WARNING 或 INFORMATION 的優先順序。log_error_verbosity 會根據允許寫入記錄的訊息優先順序來控制詳細程度，如下表所示。

還有一個 SYSTEM 的優先順序。關於非錯誤情況的系統訊息會列印到錯誤記錄，而無論 log_error_verbosity 值為何。這些訊息包括啟動和關閉訊息，以及對設定的一些重大變更。

log_error_verbosity 的效果會與 log_error_suppression_list 的效果結合。如需更多資訊，請參閱 第 7.4.2.5 節，「基於優先順序的錯誤記錄篩選 (log_filter_internal)」。

log_output

一般查詢日誌和慢查詢日誌輸出的目的地。該值是一個列表，包含一個或多個以逗號分隔的單字，可選自 TABLE、FILE 和 NONE。TABLE 選擇將日誌記錄到 mysql 系統架構中的 general_log 和 slow_log 表中。FILE 選擇將日誌記錄到日誌檔案中。NONE 禁用日誌記錄。如果值中存在 NONE，則其優先於任何其他存在的單字。TABLE 和 FILE 可以同時給定，以選擇兩個日誌輸出目的地。

此變數選擇日誌輸出目的地，但不會啟用日誌輸出。若要啟用日誌輸出，請啟用 general_log 和 slow_query_log 系統變數。對於 FILE 日誌記錄，general_log_file 和 slow_query_log_file 系統變數決定日誌檔案的位置。如需更多資訊，請參閱 第 7.4.1 節，「選取一般查詢日誌和慢查詢日誌輸出目的地」。

log_queries_not_using_indexes

如果啟用此變數並且啟用了慢查詢日誌，則預期會擷取所有資料列的查詢將被記錄。請參閱 第 7.4.5 節，「慢查詢日誌」。此選項不一定表示未使用索引。例如，使用完整索引掃描的查詢會使用索引，但仍會被記錄，因為索引不會限制資料列的數量。

log_raw

log_raw 系統變數最初設定為 --log-raw 選項的值。請參閱該選項的描述以瞭解更多資訊。系統變數也可以在執行時設定，以變更密碼遮罩行為。

log_slow_admin_statements

將慢速管理陳述式包含在寫入慢查詢日誌的陳述式中。管理陳述式包括 ALTER TABLE、ANALYZE TABLE、CHECK TABLE、CREATE INDEX、DROP INDEX、OPTIMIZE TABLE 和 REPAIR TABLE。

log_slow_extra

如果啟用了慢查詢日誌，且輸出目的地包含 FILE，則伺服器會將其他欄位寫入日誌檔案行，以提供有關慢速陳述式的資訊。請參閱 第 7.4.5 節，「慢查詢日誌」。TABLE 輸出不受影響。

log_timestamps