若要查看伺服器根據其內建預設值和其讀取的任何選項檔案所使用的值，請使用此命令

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 Cluster 系統變數」列出特定於 NDB Cluster 的系統變數。

關於特定於複製的伺服器系統變數資訊，請參閱第 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.5 節「Windows 可插拔身份驗證」。

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

authentication_windows_use_principal_name

只有在啟用 authentication_windows Windows 身份驗證插件時，此變數才可用。請參閱第 8.4.1.5 節「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 操作出現 The table tbl_name is full 錯誤，但也會減慢記憶體表格足夠應付的查詢速度。

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

bind_address

MySQL 伺服器會在一個或多個網路 Socket 上接聽 TCP/IP 連線。每個 Socket 都會繫結至一個位址，但一個位址可能會對應到多個網路介面。若要指定伺服器應如何接聽 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 指定單一值（萬用字元或非萬用字元）時，伺服器會接聽單一 Socket，對於萬用字元位址，該 Socket 可以繫結至多個網路介面。當 bind_address 指定多個值的清單時，伺服器會接聽每個值一個 Socket，而且每個 Socket 都會繫結至單一網路介面。Socket 的數量與指定的值數量成線性關係。根據作業系統接受連線的效率，較長的值清單可能會導致接受 TCP/IP 連線的效能下降。

因為檔案描述元是配置給接聽 Socket 和網路命名空間檔案的，因此可能需要增加 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

這是 160 位元的 SHA1 簽章，會在 Linux 系統上使用 -DWITH_BUILD_ID=ON 編譯伺服器時由連結器產生（預設為啟用），並轉換為十六進位字串。此唯讀值可作為唯一的組建 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 私密/公開金鑰配對檔案，伺服器會使用此變數來判斷是否要自動產生它們。

在啟動時，如果滿足以下所有條件，伺服器會在資料目錄中自動產生 RSA 私鑰/公鑰對檔案： sha256_password_auto_generate_rsa_keys 或 caching_sha2_password_auto_generate_rsa_keys 系統變數已啟用；未指定 RSA 選項；資料目錄中缺少 RSA 檔案。這些金鑰對檔案可讓使用 sha256_password 或 caching_sha2_password 外掛程式驗證的帳戶，透過未加密連線使用 RSA 安全地交換密碼；請參閱第 8.4.1.2 節「SHA-256 可插拔驗證」和 第 8.4.1.1 節「快取 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.1 節「快取 SHA-2 可插拔驗證」。

caching_sha2_password_public_key_path

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

有關 caching_sha2_password 的資訊（包括用戶端如何請求 RSA 公鑰的資訊），請參閱第 8.4.1.1 節「快取 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 中，工作階段變數將變成唯讀（並且對它們的指派會產生錯誤），在未來版本的 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 驗證外掛程式）。其他驗證外掛程式預設不支援代理使用者。 sha256_password 可以請求 MySQL 伺服器本身根據授與的代理權限來對應代理使用者。

如果啟用 check_proxy_users 系統變數，則伺服器會為任何提出此類請求的驗證外掛程式執行代理使用者對應。要利用伺服器對 sha256_password 外掛程式的代理使用者對應支援，您必須啟用 sha256_password_proxy_users。

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

collation_connection

連線字元集的校對。collation_connection 對於文字字串的比較非常重要。對於字串與欄位值的比較，collation_connection 並不重要，因為欄位有自己的校對，其校對優先順序較高（請參閱第 12.8.4 節「運算式中的校對強制轉換」）。

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

collation_database

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

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

將值指派給 session 的 character_set_database 和 collation_database 系統變數已棄用，且指派會產生警告。預期在未來版本的 MySQL 中，session 變數會變成唯讀（且指派會產生錯誤），屆時仍然可以存取 session 變數，以判斷預設資料庫的資料庫字元集和排序規則。

針對 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 允許針對資料檔案中間沒有可用區塊的 MyISAM 資料表同時執行 INSERT 和 SELECT 陳述式。

此變數可以採用下表所示的值。可以使用名稱值或對應的整數值指派變數。

如果您使用 --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 選項執行個體值。全域和 session 值可以在執行階段設定。

設定此系統變數的會期值是受限的操作。會期使用者必須具有足夠的權限才能設定受限的會期變數。請參閱第 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

此變數是除錯同步功能的用戶介面。使用除錯同步需要使用 -DWITH_DEBUG=ON CMake 選項配置 MySQL（請參閱第 2.8.7 節，「MySQL 原始碼配置選項」）；否則，此系統變數將不可用。

全域變數值為唯讀，並指示該功能是否啟用。預設情況下，除錯同步處於停用狀態，debug_sync 的值為 OFF。如果伺服器使用 --debug-sync-timeout=N 啟動，其中 N 是大於 0 的逾時值，則會啟用除錯同步，並且 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 資料表的自動檢查，方法是使用設定的 myisam_recover_options 系統變數啟動伺服器（例如，myisam_recover_options='BACKUP,FORCE'）。請參閱第 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_sink_internal 篩選器使用 log_error_verbosity=2 設定時執行的篩選類似。

可以查詢 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.5.2 節，「事件排程器組態」中有更詳細的討論。

explain_format

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

此變數的設定也會影響 EXPLAIN ANALYZE。對於此目的，DEFAULT 和 TRADITIONAL 會被解讀為 TREE。如果 explain_format 的值為 JSON，並且發出沒有 FORMAT 選項的 EXPLAIN ANALYZE 陳述式，該陳述式會引發錯誤 (ER_NOT_SUPPORTED_YET)。

在 EXPLAIN 或 EXPLAIN ANALYZE 中使用格式規範會覆寫 explain_format 的任何設定。

當使用 EXPLAIN 陳述式來顯示有關表格欄位的資訊時，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 9.0 中的預設值。將 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，「外鍵約束」。

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

將 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 變數控制主機快取的大小，以及公開快取內容的效能結構描述 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

如果使用 MyISAM 資料表且未指定 DATA DIRECTORY 選項，則 .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

此變數控制 LOAD DATA 語句的伺服器端 LOCAL 功能。根據 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

使用 --memlock 是否將 mysqld 鎖定在記憶體中。

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 9.0 錯誤訊息參考。

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