系統變數為 true 或 false 可在伺服器啟動時透過命名它們來啟用，或使用 --skip- 字首來停用。例如，若要啟用或停用 InnoDB 自適性雜湊索引，您可以使用命令列上的 --innodb-adaptive-hash-index 或 --skip-innodb-adaptive-hash-index，或是在選項檔案中使用 innodb_adaptive_hash_index 或 skip_innodb_adaptive_hash_index。

某些變數描述會參照 「啟用」 或 「停用」 變數。這些變數可以使用 SET 陳述式將它們設定為 ON 或 1 來啟用，或將它們設定為 OFF 或 0 來停用。布林變數可以在啟動時設定為值 ON、TRUE、OFF 和 FALSE（不區分大小寫），以及 1 和 0。請參閱第 6.2.2.4 節，「程式選項修飾詞」。

採用數值的系統變數可以在命令列上指定為 --var_name=value，或在選項檔案中指定為 var_name=value。

許多系統變數可以在執行階段變更（請參閱第 7.1.9.2 節，「動態系統變數」）。

如需關於 GLOBAL 和 SESSION 變數範圍修飾詞的資訊，請參考 SET 陳述式文件。

某些選項控制 InnoDB 資料檔案的位置與版面配置。第 17.8.1 節，「InnoDB 啟動組態」說明如何使用這些選項。

某些選項（您可能最初不會使用）有助於根據機器容量與資料庫工作負載來調整 InnoDB 效能特性。

如需關於指定選項與系統變數的更多資訊，請參閱第 6.2.2 節，「指定程式選項」。

--innodb-status-file

--innodb-status-file 啟動選項控制 InnoDB 是否在資料目錄中建立名為 innodb_status.pid 的檔案，並大約每 15 秒將 SHOW ENGINE INNODB STATUS 輸出寫入其中。

預設情況下不會建立 innodb_status.pid 檔案。若要建立它，請使用 --innodb-status-file 選項啟動 mysqld。InnoDB 會在伺服器正常關閉時移除該檔案。如果發生異常關閉，則可能必須手動移除狀態檔案。

--innodb-status-file 選項旨在用於臨時用途，因為產生 SHOW ENGINE INNODB STATUS 輸出可能會影響效能，而且 innodb_status.pid 檔案可能會隨著時間變得相當大。

如需相關資訊，請參閱第 17.17.2 節「啟用 InnoDB 監視器」。

innodb_adaptive_flushing

指定是否根據工作負載動態調整 InnoDB 緩衝池中 髒頁的清除速率。動態調整清除速率旨在避免 I/O 活動的爆發。預設會啟用此設定。如需詳細資訊，請參閱第 17.8.3.5 節「設定緩衝池清除」。如需一般 I/O 調整建議，請參閱第 10.5.8 節「最佳化 InnoDB 磁碟 I/O」。

innodb_adaptive_flushing_lwm

定義 重做記錄 容量的低水位標記，該標記表示啟用 自適應清除的百分比。如需詳細資訊，請參閱第 17.8.3.5 節「設定緩衝池清除」。

innodb_adaptive_hash_index

是否啟用或停用 InnoDB 自適應雜湊索引。視您的工作負載而定，可能需要動態啟用或停用 自適應雜湊索引，以改善查詢效能。由於自適應雜湊索引可能不適用於所有工作負載，請使用真實工作負載，在啟用和停用的情況下執行基準測試。如需詳細資訊，請參閱第 17.5.3 節「自適應雜湊索引」。

此變數預設為停用。您可以使用 SET GLOBAL 陳述式修改此參數，而無需重新啟動伺服器。在執行階段變更設定需要有足夠的權限來設定全域系統變數。請參閱第 7.1.9.1 節「系統變數權限」。您也可以在伺服器啟動時使用 --innodb-adaptive-hash-index 來啟用它。

停用自適應雜湊索引會立即清空雜湊表。在清空雜湊表時，可以繼續進行正常操作，而執行使用雜湊表的查詢會改為直接存取索引 B 樹。當重新啟用自適應雜湊索引時，雜湊表會在正常操作期間再次填入。

在 MySQL 8.4 之前，此選項預設為啟用。

innodb_adaptive_hash_index_parts

分割自適應雜湊索引搜尋系統。每個索引都會繫結至特定的分割區，而每個分割區都會受到個別的閂鎖保護。

預設會將自適應雜湊索引搜尋系統分割成 8 個部分。最大設定為 512。

如需相關資訊，請參閱第 17.5.3 節「自適應雜湊索引」。

innodb_adaptive_max_sleep_delay

允許 InnoDB 根據當前的工作負載自動調整 innodb_thread_sleep_delay 的值。任何非零值都會啟用 innodb_thread_sleep_delay 值的自動動態調整，最高可達 innodb_adaptive_max_sleep_delay 選項中指定的最大值。該值表示微秒數。此選項在繁忙的系統中非常有用，尤其是當 InnoDB 線程數大於 16 個時。（實際上，它對於具有數百甚至數千個同時連線的 MySQL 系統最有價值。）

如需更多資訊，請參閱 第 17.8.4 節，「為 InnoDB 設定執行緒並行性」。

innodb_autoextend_increment

當自動擴充的 InnoDB 系統表空間檔案滿時，其擴充大小的增量（以 MB 為單位）。預設值為 64。如需相關資訊，請參閱系統表空間資料檔案設定，以及調整系統表空間大小。

innodb_autoextend_increment 設定不會影響每個表一個檔案的表空間檔案或一般表空間檔案。無論innodb_autoextend_increment 設定為何，這些檔案都會自動擴充。初始擴充量很小，之後擴充將以 4MB 為增量進行。

innodb_autoinc_lock_mode

用於產生自動遞增值的鎖定模式。允許的值為 0、1 或 2，分別代表傳統、連續或交錯模式。

預設設定為 2 (交錯)，與基於列的複寫相容。

如需每個鎖定模式的特性，請參閱 InnoDB AUTO_INCREMENT 鎖定模式。

innodb_background_drop_list_empty

啟用 innodb_background_drop_list_empty 偵錯選項，有助於避免測試案例失敗，方法是延遲表格建立，直到背景刪除清單為空為止。例如，如果測試案例 A 將表格 t1 放置在背景刪除清單中，則測試案例 B 會等到背景刪除清單為空時，才建立表格 t1。

innodb_buffer_pool_chunk_size

innodb_buffer_pool_chunk_size 定義 InnoDB 緩衝池調整大小作業的區塊大小。

為了避免在調整大小作業期間複製所有緩衝池頁面，作業會以「區塊」的形式執行。預設情況下，innodb_buffer_pool_chunk_size 為 128MB (134217728 位元組)。區塊中包含的頁面數量取決於innodb_page_size 的值。innodb_buffer_pool_chunk_size 可以以 1MB (1048576 位元組) 為單位增加或減少。

變更 innodb_buffer_pool_chunk_size 值時，適用以下條件

為了避免潛在的效能問題，區塊數 (innodb_buffer_pool_size / innodb_buffer_pool_chunk_size) 不應超過 1000。

innodb_buffer_pool_size 變數是動態的，允許在伺服器線上時調整緩衝池大小。但是，緩衝池大小必須等於或為 innodb_buffer_pool_chunk_size * innodb_buffer_pool_instances 的倍數，而且變更這些變數設定的任一項都需要重新啟動伺服器。

如需更多資訊，請參閱 第 17.8.3.1 節，「設定 InnoDB 緩衝池大小」。

innodb_buffer_pool_debug

啟用此選項允許在緩衝池大小小於 1GB 時使用多個緩衝池實例，這會忽略對 innodb_buffer_pool_instances 強制的 1GB 最小緩衝池大小限制。innodb_buffer_pool_debug 選項僅在使用 WITH_DEBUG CMake 選項編譯偵錯支援時才可用。

innodb_buffer_pool_dump_at_shutdown

指定在關閉 MySQL 伺服器時是否要記錄 InnoDB 緩衝池中快取的頁面，以縮短下次重新啟動時的暖機過程。通常與 innodb_buffer_pool_load_at_startup 結合使用。innodb_buffer_pool_dump_pct 選項定義要傾印的最近使用緩衝池頁面百分比。

innodb_buffer_pool_dump_at_shutdown 和 innodb_buffer_pool_load_at_startup 預設都已啟用。

如需更多資訊，請參閱 第 17.8.3.6 節，「儲存和還原緩衝池狀態」。

innodb_buffer_pool_dump_now

立即記錄 InnoDB 緩衝池中快取的頁面。通常與 innodb_buffer_pool_load_now 結合使用。

啟用 innodb_buffer_pool_dump_now 會觸發記錄動作，但不會變更變數設定，該設定始終保持 OFF 或 0。若要檢視觸發傾印後的緩衝池傾印狀態，請查詢 Innodb_buffer_pool_dump_status 變數。

啟用 innodb_buffer_pool_dump_now 會觸發傾印動作，但不會變更變數設定，該設定始終保持 OFF 或 0。若要檢視觸發傾印後的緩衝池傾印狀態，請查詢 Innodb_buffer_pool_dump_status 變數。

如需更多資訊，請參閱 第 17.8.3.6 節，「儲存和還原緩衝池狀態」。

innodb_buffer_pool_dump_pct

指定要讀取和傾印的每個緩衝池最近使用頁面百分比。範圍是 1 到 100。預設值為 25。例如，如果有 4 個緩衝池，每個緩衝池有 100 個頁面，且 innodb_buffer_pool_dump_pct 設定為 25，則會傾印每個緩衝池的 25 個最近使用頁面。

innodb_buffer_pool_filename

指定保存 innodb_buffer_pool_dump_at_shutdown 或 innodb_buffer_pool_dump_now 所產生的表空間 ID 和頁面 ID 清單的檔案名稱。表空間 ID 和頁面 ID 會以以下格式儲存：space, page_id。預設情況下，該檔案名為 ib_buffer_pool，且位於 InnoDB 資料目錄中。非預設位置必須相對於資料目錄指定。

可以使用 SET 陳述式在執行時指定檔案名稱

SET GLOBAL innodb_buffer_pool_filename='file_name';

您也可以在啟動時，在啟動字串或 MySQL 設定檔中指定檔案名稱。在啟動時指定檔案名稱時，該檔案必須存在，否則 InnoDB 會傳回啟動錯誤，指出沒有該檔案或目錄。

如需更多資訊，請參閱 第 17.8.3.6 節，「儲存和還原緩衝池狀態」。

innodb_buffer_pool_in_core_file

停用（預設）innodb_buffer_pool_in_core_file 變數會將 InnoDB 快取池頁面排除在外，以減少核心檔案的大小。

若要使用此變數，必須啟用 core_file 變數，且要停用此選項，作業系統必須支援 madvise() 的非 POSIX 擴充功能 MADV_DONTDUMP，Linux 3.4 及更高版本支援此功能。有關詳細資訊，請參閱第 17.8.3.7 節「從核心檔案排除或包含緩衝池頁面」。

在支援 MADV_DONTDUMP 的系統上預設為停用，通常僅限於 Linux，而非 macOS 或 Windows。

在 MySQL 8.4 之前，此選項預設為啟用。

innodb_buffer_pool_instances

InnoDB 緩衝池所劃分的區域數量。對於具有數 GB 範圍緩衝池的系統，將緩衝池劃分為單獨的實例可以提高並行性，減少不同執行緒讀取和寫入快取頁面時的競爭。儲存在緩衝池中或從緩衝池讀取的每個頁面都會使用雜湊函數隨機分配到其中一個緩衝池實例。每個緩衝池管理自己的可用列表、刷新列表、LRU，以及所有其他與緩衝池相關聯的資料結構，並由其自己的緩衝池 互斥鎖保護。

總緩衝池大小會在所有緩衝池之間分配。為了達到最佳效率，請指定 innodb_buffer_pool_instances 和 innodb_buffer_pool_size 的組合，以使每個緩衝池實例至少為 1GB。

如果 innodb_buffer_pool_size <= 1 GiB，則預設的 innodb_buffer_pool_instances 值為 1。

如果 innodb_buffer_pool_size > 1 GiB，則預設的 innodb_buffer_pool_instances 值是以下兩個計算提示中的最小值，範圍在 1-64 之間

有關相關資訊，請參閱第 17.8.3.1 節「設定 InnoDB 緩衝池大小」。

innodb_buffer_pool_load_abort

中斷由 innodb_buffer_pool_load_at_startup 或 innodb_buffer_pool_load_now 觸發的還原 InnoDB 緩衝池 內容的程序。

啟用 innodb_buffer_pool_load_abort 會觸發中止動作，但不會變更變數設定，該設定始終保持 OFF 或 0。若要檢視觸發中止動作後的緩衝池載入狀態，請查詢 Innodb_buffer_pool_load_status 變數。

如需更多資訊，請參閱 第 17.8.3.6 節，「儲存和還原緩衝池狀態」。

innodb_buffer_pool_load_at_startup

指定在 MySQL 伺服器啟動時，InnoDB 緩衝池會透過載入先前保留的相同頁面來自動暖機。通常與 innodb_buffer_pool_dump_at_shutdown 搭配使用。

innodb_buffer_pool_dump_at_shutdown 和 innodb_buffer_pool_load_at_startup 預設都已啟用。

如需更多資訊，請參閱 第 17.8.3.6 節，「儲存和還原緩衝池狀態」。

innodb_buffer_pool_load_now

立即暖機 InnoDB 緩衝池，方法是載入資料頁面，而無需等待伺服器重新啟動。在基準測試期間將快取記憶體恢復到已知狀態，或者在執行報告或維護查詢後讓 MySQL 伺服器準備好恢復正常工作負載時，可能會很有用。

啟用 innodb_buffer_pool_load_now 會觸發載入動作，但不會變更變數設定，該設定始終保持 OFF 或 0。若要檢視觸發載入後的緩衝池載入進度，請查詢 Innodb_buffer_pool_load_status 變數。

如需更多資訊，請參閱 第 17.8.3.6 節，「儲存和還原緩衝池狀態」。

innodb_buffer_pool_size

緩衝池的大小（以位元組為單位），即 InnoDB 快取表格和索引資料的記憶體區域。預設值為 134217728 位元組 (128MB)。最大值取決於 CPU 架構；在 32 位元系統上最大值為 4294967295 (2³²-1)，在 64 位元系統上最大值為 18446744073709551615 (2⁶⁴-1)。在 32 位元系統上，CPU 架構和作業系統可能會強制執行比所述最大值更低的實際最大大小。當緩衝池的大小大於 1GB 時，將 innodb_buffer_pool_instances 設定為大於 1 的值可以提高繁忙伺服器上的延展性。

較大的緩衝池需要較少的磁碟 I/O 才能多次存取相同的表格資料。在專用資料庫伺服器上，您可以將緩衝池大小設定為機器實體記憶體大小的 80%。請注意設定緩衝池大小時的以下潛在問題，並準備好在必要時縮減緩衝池的大小。

當您增加或減少緩衝池大小時，該操作會以區塊執行。區塊大小由 innodb_buffer_pool_chunk_size 變數定義，預設值為 128 MB。

緩衝池大小必須始終等於或為 innodb_buffer_pool_chunk_size * innodb_buffer_pool_instances 的倍數。如果您將緩衝池大小變更為不等於或不為 innodb_buffer_pool_chunk_size * innodb_buffer_pool_instances 倍數的值，則緩衝池大小會自動調整為等於或為 innodb_buffer_pool_chunk_size * innodb_buffer_pool_instances 倍數的值。

innodb_buffer_pool_size 可以動態設定，這允許您調整緩衝池大小而無需重新啟動伺服器。Innodb_buffer_pool_resize_status 狀態變數會報告線上緩衝池調整大小操作的狀態。有關詳細資訊，請參閱第 17.8.3.1 節「設定 InnoDB 緩衝池大小」。

如果啟用 innodb_dedicated_server，則如果未明確定義 innodb_buffer_pool_size 值，將會自動設定。有關詳細資訊，請參閱第 17.8.12 節「為專用 MySQL 伺服器啟用自動組態」。

innodb_change_buffer_max_size

InnoDB 變更緩衝區的最大大小，以 緩衝池總大小的百分比表示。您可能會為具有大量插入、更新和刪除活動的 MySQL 伺服器增加此值，或為用於報告且資料不變的 MySQL 伺服器減少此值。有關詳細資訊，請參閱第 17.5.2 節「變更緩衝區」。有關一般 I/O 調整建議，請參閱第 10.5.8 節「最佳化 InnoDB 磁碟 I/O」。

innodb_change_buffering

是否 InnoDB 執行變更緩衝，這是一種最佳化，會延遲對次要索引的寫入操作，以便可以循序執行 I/O 操作。允許的值如下表所述。也可以使用數值指定值。

在 MySQL 8.4 之前，預設值為 all。

如需更多資訊，請參閱第 17.5.2 節「變更緩衝區」。如需一般 I/O 調整建議，請參閱第 10.5.8 節「最佳化 InnoDB 磁碟 I/O」。

innodb_change_buffering_debug

設定 InnoDB 變更緩衝的偵錯旗標。值 1 強制將所有變更放入變更緩衝區。值 2 會在合併時導致非預期的結束。預設值 0 表示未設定變更緩衝偵錯旗標。只有在使用 WITH_DEBUG CMake 選項編譯時，才能使用此選項。

innodb_checkpoint_disabled

這是一個偵錯選項，僅供專家偵錯使用。它會停用檢查點，以便在伺服器刻意結束時一律啟動 InnoDB 復原。它應僅在短時間內啟用，通常是在執行 DML 操作之前，這些操作會寫入需要伺服器結束後復原的重做日誌項目。只有在使用 WITH_DEBUG CMake 選項編譯時，才能使用此選項。

innodb_checksum_algorithm

指定如何產生和驗證儲存在 InnoDB 表空間的磁碟區塊中的檢查和。 innodb_checksum_algorithm 的預設值為 crc32。

值 innodb 與舊版 MySQL 向後相容。值 crc32 使用一種演算法，可以更快地計算每個修改區塊的檢查和，並檢查每個磁碟讀取的檢查和。它一次掃描 64 位元區塊，比 innodb 檢查和演算法 (一次掃描 8 位元區塊) 快。值 none 會在檢查和欄位中寫入常數值，而不是根據區塊資料計算值。表空間中的區塊可以使用舊的、新的和無檢查和值的組合，並在修改資料時逐漸更新；一旦修改表空間中的區塊以使用 crc32 演算法，舊版 MySQL 就無法讀取相關的表。

如果檢查和演算法的嚴格形式在表空間中遇到有效但不符的檢查和值，則會報告錯誤。建議您僅在新執行個體中使用嚴格設定，以便首次設定表空間。嚴格設定的速度稍快，因為它們不需要在磁碟讀取期間計算所有檢查和值。

下表顯示 none、innodb 和 crc32 選項值及其嚴格對應項之間的差異。none、innodb 和 crc32 會將指定的檢查和值類型寫入每個資料區塊，但為了相容性，在讀取操作期間驗證區塊時，會接受其他檢查和值。嚴格設定也會接受有效的檢查和值，但當遇到有效但不符的檢查和值時，會列印錯誤訊息。如果執行個體中的所有 InnoDB 資料檔案都是在相同的 innodb_checksum_algorithm 值下建立的，則使用嚴格形式可以加快驗證速度。

innodb_cmp_per_index_enabled

啟用資訊綱要 INNODB_CMP_PER_INDEX 表中與每個索引相關的壓縮統計資料。由於收集這些統計資料可能會很耗費資源，因此僅在開發、測試或複本執行個體上啟用此選項，以便進行與 InnoDB 壓縮表相關的效能調整。

如需更多資訊，請參閱第 28.4.8 節「INFORMATION_SCHEMA INNODB_CMP_PER_INDEX 和 INNODB_CMP_PER_INDEX_RESET 表」，以及第 17.9.1.4 節「在執行階段監控 InnoDB 表壓縮」。

innodb_commit_concurrency

可以同時提交的執行緒數目。值 0 (預設值) 允許任意數量的交易同時提交。

無法在執行階段將 innodb_commit_concurrency 的值從零變更為非零值，反之亦然。該值可以從一個非零值變更為另一個非零值。

innodb_compress_debug

使用指定的壓縮演算法壓縮所有表，而無需為每個表定義 COMPRESSION 屬性。只有在使用 WITH_DEBUG CMake 選項編譯時，才能使用此選項。

如需相關資訊，請參閱第 17.9.2 節「InnoDB 頁面壓縮」。

innodb_compression_failure_threshold_pct

定義表的壓縮失敗率臨界值 (百分比)，當達到該臨界值時，MySQL 會開始在壓縮頁面內新增填補，以避免耗費資源的壓縮失敗。當超過此臨界值時，MySQL 會開始在每個新的壓縮頁面內保留額外的可用空間，動態調整可用空間量，最高可達 innodb_compression_pad_pct_max 指定的頁面大小百分比。值零會停用監控壓縮效率並動態調整填補量的機制。

如需更多資訊，請參閱第 17.9.1.6 節「OLTP 工作負載的壓縮」。

innodb_compression_level

指定用於 InnoDB 壓縮表和索引的 zlib 壓縮層級。較高的值可讓您在儲存裝置上容納更多資料，但會增加壓縮期間的 CPU 額外負荷。較低的值可讓您在儲存空間不重要時，或預期資料並非特別可壓縮時，減少 CPU 額外負荷。

如需更多資訊，請參閱第 17.9.1.6 節「OLTP 工作負載的壓縮」。

innodb_compression_pad_pct_max

指定在每個壓縮頁面內可以保留為可用空間的最大百分比，以便在更新壓縮表或索引並且可能重新壓縮資料時，允許空間重新組織頁面內的資料和修改記錄。僅當 innodb_compression_failure_threshold_pct 設定為非零值，且壓縮失敗率超過臨界點時才適用。

如需更多資訊，請參閱第 17.9.1.6 節「OLTP 工作負載的壓縮」。

innodb_concurrency_tickets

決定可以同時進入 InnoDB 的執行緒數量。當執行緒嘗試進入 InnoDB 時，如果執行緒數量已達到並行限制，則該執行緒會被放入佇列中。當允許執行緒進入 InnoDB 時，它會被賦予等同於 innodb_concurrency_tickets 值的 「票券」數量，並且該執行緒可以自由地進出 InnoDB，直到用完所有票券。在那之後，該執行緒下次嘗試進入 InnoDB 時，將再次受到並行檢查（以及可能需要排隊）。預設值為 5000。

使用較小的 innodb_concurrency_tickets 值，只需要處理少量資料列的小型交易，可以與處理大量資料列的較大型交易公平競爭。較小的 innodb_concurrency_tickets 值的缺點是，大型交易在完成之前必須多次循環佇列，這會延長完成其任務所需的時間。

使用較大的 innodb_concurrency_tickets 值，大型交易在佇列末端等待位置的時間（由 innodb_thread_concurrency 控制）會減少，而花費更多時間來檢索資料列。大型交易也需要較少的佇列行程才能完成其任務。較大的 innodb_concurrency_tickets 值的缺點是，同時執行過多大型交易可能會讓小型交易等待更久才能執行，而導致小型交易處於飢餓狀態。

使用非零的 innodb_thread_concurrency 值，您可能需要向上或向下調整 innodb_concurrency_tickets 值，以找到大型交易和小型交易之間的最佳平衡。 SHOW ENGINE INNODB STATUS 報告會顯示執行中交易目前通過佇列時剩餘的票券數量。此資料也可以從 Information Schema 的 INNODB_TRX 資料表的 TRX_CONCURRENCY_TICKETS 欄位取得。

如需更多資訊，請參閱 第 17.8.4 節，「為 InnoDB 設定執行緒並行性」。

innodb_data_file_path

定義 InnoDB 系統表空間資料檔案的名稱、大小和屬性。如果您未指定 innodb_data_file_path 的值，預設行為是建立一個自動擴展的資料檔案，略大於 12MB，名為 ibdata1。

資料檔案規格的完整語法包括檔案名稱、檔案大小、autoextend 屬性和 max 屬性

file_name:file_size[:autoextend[:max:max_file_size]]

檔案大小以 KB、MB 或 GB 為單位指定，方法是在大小值後附加 K、M 或 G。如果以 KB 為單位指定資料檔案大小，請以 1024 的倍數執行。否則，KB 值會四捨五入到最接近的 MB 邊界。檔案大小的總和必須至少略大於 12MB。

如需其他組態資訊，請參閱系統表空間資料檔案組態。如需調整大小的指示，請參閱調整系統表空間的大小。

innodb_data_home_dir

InnoDB 系統表空間資料檔案的目錄路徑的通用部分。預設值是 MySQL 的 data 目錄。除非該設定定義了絕對路徑，否則此設定會與 innodb_data_file_path 設定串連。

指定 innodb_data_home_dir 的值時，需要加上尾部的斜線。例如

[mysqld]
innodb_data_home_dir = /path/to/myibdata/

此設定不會影響每個資料表一個檔案的表空間的位置。

如需相關資訊，請參閱第 17.8.1 節，「InnoDB 啟動組態」。

innodb_ddl_buffer_size

定義 DDL 操作的最大緩衝區大小。預設設定為 1048576 個位元組 (約 1 MB)。適用於建立或重建次要索引的線上 DDL 操作。請參閱第 17.12.4 節，「線上 DDL 記憶體管理」。每個 DDL 執行緒的最大緩衝區大小是最大緩衝區大小除以 DDL 執行緒數 (innodb_ddl_buffer_size/innodb_ddl_threads)。

innodb_ddl_log_crash_reset_debug

啟用此偵錯選項可將 DDL 記錄損毀注入計數器重設為 1。只有在使用 WITH_DEBUG CMake 選項編譯偵錯支援時，此選項才可用。

innodb_ddl_threads

定義索引建立的排序和建置階段的最大平行執行緒數。適用於建立或重建次要索引的線上 DDL 操作。如需相關資訊，請參閱第 17.12.5 節，「設定線上 DDL 操作的平行執行緒」和第 17.12.4 節，「線上 DDL 記憶體管理」。

innodb_deadlock_detect

此選項用於停用死鎖偵測。在高並行系統上，當多個執行緒等待相同的鎖定時，死鎖偵測可能會導致效能降低。有時，停用死鎖偵測並在發生死鎖時依賴 innodb_lock_wait_timeout 設定進行交易回滾可能更有效率。

如需相關資訊，請參閱第 17.7.5.2 節，「死鎖偵測」。

innodb_dedicated_server

啟用 innodb_dedicated_server 時，InnoDB 會自動設定下列變數

只有在 MySQL 執行個體位於專用伺服器上，可以使用所有可用的系統資源時，才考慮啟用 innodb_dedicated_server。如果 MySQL 執行個體與其他應用程式共用系統資源，則不建議啟用 innodb_dedicated_server。

如需詳細資訊，請參閱第 17.8.12 節，「為專用 MySQL 伺服器啟用自動組態」。

innodb_default_row_format

innodb_default_row_format 選項定義 InnoDB 資料表和使用者建立的暫存資料表的預設資料列格式。預設設定為 DYNAMIC。其他允許的值為 COMPACT 和 REDUNDANT。COMPRESSED 資料列格式不支援在系統表空間中使用，因此無法定義為預設值。

當未明確指定 ROW_FORMAT 選項或使用 ROW_FORMAT=DEFAULT 時，新建立的資料表會使用 innodb_default_row_format 定義的資料列格式。

當未明確指定 ROW_FORMAT 選項或使用 ROW_FORMAT=DEFAULT 時，任何重建資料表的操作也會以無聲方式將資料表的資料列格式變更為 innodb_default_row_format 定義的格式。如需詳細資訊，請參閱定義資料表的資料列格式。

伺服器為處理查詢而建立的內部 InnoDB 暫存表格會使用 DYNAMIC 列格式，無論 innodb_default_row_format 設定為何。

innodb_directories

定義啟動時要掃描表格空間檔案的目錄。此選項用於在伺服器離線時將表格空間檔案移動或還原到新位置。它也用於指定使用絕對路徑建立或位於資料目錄外部的表格空間檔案目錄。

在當機復原期間的表格空間探索，依賴於 innodb_directories 設定來識別重做日誌中引用的表格空間。有關更多資訊，請參閱 當機復原期間的表格空間探索。

預設值為 NULL，但由 innodb_data_home_dir、innodb_undo_directory 和 datadir 定義的目錄，始終會附加到 innodb_directories 引數值，當 InnoDB 在啟動時建立要掃描的目錄清單時。無論是否明確指定 innodb_directories 設定，這些目錄都會附加。

innodb_directories 可以指定為啟動命令中的選項，或在 MySQL 選項檔案中。引數值用引號括起來，因為否則某些命令直譯器會將分號 (;) 解釋為特殊字元。（例如，Unix Shell 會將其視為命令終止符。）

啟動命令

mysqld --innodb-directories="directory_path_1;directory_path_2"

MySQL 選項檔案

[mysqld]
innodb_directories="directory_path_1;directory_path_2"

不可以使用萬用字元運算式來指定目錄。

innodb_directories 掃描也會遍歷指定目錄的子目錄。重複的目錄和子目錄會從要掃描的目錄清單中捨棄。

有關更多資訊，請參閱 第 17.6.3.6 節， 「在伺服器離線時移動表格空間檔案」。

innodb_disable_sort_file_cache

針對合併排序暫存檔案停用作業系統檔案系統快取。效果是以相當於 O_DIRECT 的方式開啟此類檔案。

innodb_doublewrite

innodb_doublewrite 變數控制雙寫緩衝。在大多數情況下，預設會啟用雙寫緩衝。

您可以在啟動伺服器時將 innodb_doublewrite 設定為 ON 或 OFF，以分別啟用或停用雙寫緩衝。DETECT_AND_RECOVER 與 ON 相同。使用此設定時，雙寫緩衝區會完全啟用，資料庫頁面內容會寫入雙寫緩衝區，以便在復原期間存取，以修正不完整的頁面寫入。使用 DETECT_ONLY 時，只有中繼資料會寫入雙寫緩衝區。資料庫頁面內容不會寫入雙寫緩衝區，復原不會使用雙寫緩衝區來修正不完整的頁面寫入。此輕量級設定僅用於偵測不完整的頁面寫入。

MySQL 支援對 innodb_doublewrite 設定進行動態變更，以在 ON、DETECT_AND_RECOVER 和 DETECT_ONLY 之間啟用雙寫緩衝區。MySQL 不支援在啟用雙寫緩衝區的設定與 OFF 之間進行動態變更，反之亦然。

如果雙寫緩衝區位於支援原子寫入的 Fusion-io 裝置上，則會自動停用雙寫緩衝區，並改用 Fusion-io 原子寫入執行資料檔案寫入。但是，請注意 innodb_doublewrite 設定是全域的。當停用雙寫緩衝區時，會針對所有資料檔案停用，包括未位於 Fusion-io 硬體上的資料檔案。此功能僅在 Fusion-io 硬體上支援，並且僅針對 Linux 上的 Fusion-io NVMFS 啟用。為了充分利用此功能，建議使用 O_DIRECT 的 innodb_flush_method 設定。

有關相關資訊，請參閱 第 17.6.4 節， 「雙寫緩衝區」。

innodb_doublewrite_batch_size

此變數旨在表示批次寫入的雙寫頁面數量。此功能已由 innodb_doublewrite_pages 取代。

有關更多資訊，請參閱 第 17.6.4 節， 「雙寫緩衝區」。

innodb_doublewrite_dir

定義雙寫檔案的目錄。如果未指定目錄，則會在 innodb_data_home_dir 目錄中建立雙寫檔案，如果未指定，則預設為資料目錄。

有關更多資訊，請參閱 第 17.6.4 節， 「雙寫緩衝區」。

innodb_doublewrite_files

定義雙寫檔案的數量。預設情況下，會為每個緩衝池執行個體建立兩個雙寫檔案。

最少有兩個雙寫檔案。雙寫檔案的最大數量是緩衝池執行個體數量的兩倍。（緩衝池執行個體的數量由 innodb_buffer_pool_instances 變數控制。）

有關更多資訊，請參閱 第 17.6.4 節， 「雙寫緩衝區」。

innodb_doublewrite_pages

定義每個執行緒在批次寫入時的最大雙寫頁面數量。如果未指定值，則 innodb_doublewrite_pages 預設為 128。

在 MySQL 8.4 之前，預設值為 innodb_write_io_threads 值，預設值為 4。

有關更多資訊，請參閱 第 17.6.4 節， 「雙寫緩衝區」。

innodb_extend_and_initialize

控制在 Linux 系統上如何為每個表格檔案空間和通用表格空間配置空間。

啟用時，InnoDB 會將 NULL 寫入新配置的頁面。停用時，會使用 posix_fallocate() 呼叫配置空間，這會保留空間，而不會實際寫入 NULL。

有關更多資訊，請參閱 第 17.6.3.8 節， 「在 Linux 上最佳化表格空間空間配置」。

innodb_fast_shutdown

InnoDB 關機模式。如果值為 0，InnoDB 會執行慢速關機、完整的 清除，以及在關機之前合併變更緩衝區。如果值為 1（預設值），InnoDB 會在關機時略過這些操作，此過程稱為快速關機。如果值為 2，InnoDB 會刷新其日誌並冷關機，如同 MySQL 當機一樣；不會遺失任何已提交的交易，但當機復原操作會使下次啟動花費更長的時間。

慢速關機可能需要數分鐘，甚至在大量資料仍在緩衝時，在極端情況下可能需要數小時。在 MySQL 主要版本之間升級或降級之前，請使用慢速關機技術，以便在升級過程更新檔案格式時，所有資料檔案都已完全準備就緒。

在緊急情況或疑難排解情況下，請使用 innodb_fast_shutdown=2，以便在資料面臨損毀風險時，獲得絕對最快的關機。

innodb_fil_make_page_dirty_debug

預設情況下，將 innodb_fil_make_page_dirty_debug 設定為表格空間的 ID，會立即將表格空間的第一頁設為髒頁。如果 innodb_saved_page_number_debug 設定為非預設值，則設定 innodb_fil_make_page_dirty_debug 會將指定的頁面設為髒頁。innodb_fil_make_page_dirty_debug 選項僅在使用 WITH_DEBUG CMake 選項編譯偵錯支援時才可用。

innodb_file_per_table

當 innodb_file_per_table 啟用時，預設會在每個表格的獨立表空間中建立表格。停用時，預設會在系統表空間中建立表格。有關每個表格的獨立表空間資訊，請參閱第 17.6.3.2 節，「每個表格的獨立表空間」。有關 InnoDB 系統表空間的資訊，請參閱第 17.6.3.1 節，「系統表空間」。

可以透過 SET GLOBAL 陳述式在執行階段設定 innodb_file_per_table 變數、在啟動時在命令列中指定，或在選項檔案中指定。在執行階段設定需要足夠的權限才能設定全域系統變數（請參閱第 7.1.9.1 節，「系統變數權限」），並會立即影響所有連線的操作。

當截斷或刪除位於每個表格的獨立表空間中的表格時，釋放的空間會返回給作業系統。截斷或刪除位於系統表空間中的表格只會釋放系統表空間中的空間。系統表空間中釋放的空間可以再次用於 InnoDB 資料，但不會返回給作業系統，因為系統表空間資料檔案永遠不會縮小。

innodb_file_per-table 設定不會影響暫存表格的建立；暫存表格會在工作階段暫存表空間中建立。請參閱第 17.6.3.5 節，「暫存表空間」。

innodb_fill_factor

InnoDB 在建立或重建索引時執行大量載入。這種索引建立方法稱為「排序索引建立」。

innodb_fill_factor 定義在排序索引建立期間，每個 B 樹頁面所填滿的空間百分比，剩餘的空間則保留供未來索引增長使用。例如，將 innodb_fill_factor 設定為 80 會保留每個 B 樹頁面 20% 的空間供未來索引增長使用。實際百分比可能有所不同。innodb_fill_factor 設定會被解讀為提示，而非硬性限制。

將 innodb_fill_factor 設定為 100 會在叢集索引頁面中留下 1/16 的空間，以供未來索引增長使用。

innodb_fill_factor 適用於 B 樹的葉節點和非葉節點頁面。它不適用於用於 TEXT 或 BLOB 條目的外部頁面。

有關更多資訊，請參閱第 17.6.2.3 節，「排序索引建立」。

innodb_flush_log_at_timeout

每隔 N 秒寫入並刷新日誌。innodb_flush_log_at_timeout 允許增加刷新之間的逾時時間，以減少刷新並避免影響二進位日誌群組提交的效能。innodb_flush_log_at_timeout 的預設設定為每秒一次。

innodb_flush_log_at_trx_commit

控制 commit 操作的嚴格 ACID 合規性與重新排列和分批完成 commit 相關 I/O 操作時可能實現的更高效能之間的平衡。您可以透過變更預設值來實現更好的效能，但隨後您可能會在當機時遺失交易。

為了在使用交易的 InnoDB 複製設定中達到持久性和一致性：

有關複本上最能抵禦意外停止的設定組合資訊，請參閱第 19.4.2 節，「處理複本的意外停止」。

innodb_flush_method

定義將資料 刷新到 InnoDB 資料檔案和 日誌檔案的方法，這會影響 I/O 輸送量。

在類 Unix 系統上，預設值為 O_DIRECT（如果支援），否則預設為 fsync。在 Windows 上，預設值為 unbuffered。

用於類 Unix 系統的 innodb_flush_method 選項包括：

在支援 fdatasync() 系統呼叫的平台上，innodb_use_fdatasync 變數允許使用 fsync() 的 innodb_flush_method 選項改用 fdatasync()。除非後續資料擷取需要，否則 fdatasync() 系統呼叫不會刷新對檔案中繼資料的變更，這可能會帶來效能優勢。

Windows 系統的 innodb_flush_method 選項包括：

每個設定如何影響效能取決於硬體組態和工作負載。請針對您的特定組態進行基準測試，以決定要使用哪個設定，或是否保留預設設定。檢查 Innodb_data_fsyncs 狀態變數，以查看每個設定的 fsync() 呼叫總數（如果啟用 innodb_use_fdatasync，則為 fdatasync() 呼叫）。工作負載中讀取和寫入操作的組合會影響設定的效能。例如，在具有硬體 RAID 控制器和電池備份寫入快取的系統上，O_DIRECT 可以幫助避免 InnoDB 緩衝池和作業系統檔案系統快取之間的雙重緩衝。在某些 InnoDB 資料和記錄檔位於 SAN 上的系統中，對於主要為 SELECT 語句的讀取繁重工作負載，預設值或 O_DSYNC 可能會更快。請務必使用反映您生產環境的硬體和工作負載測試此參數。如需一般 I/O 調整建議，請參閱第 10.5.8 節「最佳化 InnoDB 磁碟 I/O」。

innodb_flush_neighbors

指定從 InnoDB 緩衝池刷新頁面時，是否也刷新同一範圍中的其他髒頁。

當表格資料儲存在傳統的 HDD 儲存裝置上時，與在不同時間刷新個別頁面相比，在一個操作中刷新這些相鄰頁面可減少 I/O 負擔（主要針對磁碟搜尋操作）。對於儲存在 SSD 上的表格資料，搜尋時間不是重要因素，您可以將此選項設定為 0，以分散寫入操作。如需相關資訊，請參閱第 17.8.3.5 節「設定緩衝池刷新」。

innodb_flush_sync

預設情況下啟用的 innodb_flush_sync 變數，會導致在 檢查點發生的 I/O 活動爆發期間，忽略 innodb_io_capacity 和 innodb_io_capacity_max 設定。若要遵循 innodb_io_capacity 和 innodb_io_capacity_max 定義的 I/O 速率，請停用 innodb_flush_sync。

如需設定 innodb_flush_sync 變數的資訊，請參閱第 17.8.7 節「設定 InnoDB I/O 容量」。

innodb_flushing_avg_loops

InnoDB 保留先前計算的刷新狀態快照的迭代次數，控制自適應刷新如何快速回應不斷變化的工作負載。增加此值會使刷新操作速率隨著工作負載的變化而平滑且逐漸地變化。減少此值會使自適應刷新快速調整以適應工作負載的變化，如果工作負載突然增加和減少，可能會導致刷新活動出現峰值。

如需相關資訊，請參閱第 17.8.3.5 節「設定緩衝池刷新」。

innodb_force_load_corrupted

允許 InnoDB 在啟動時載入標記為損毀的表格。僅在疑難排解期間使用，以復原其他無法存取的資料。疑難排解完成後，請停用此設定並重新啟動伺服器。

innodb_force_recovery

當機復原模式，通常僅在嚴重的疑難排解情況下才會變更。可能的值為 0 到 6。如需這些值的含義和關於 innodb_force_recovery 的重要資訊，請參閱第 17.20.3 節「強制 InnoDB 復原」。

innodb_fsync_threshold

依預設，當 InnoDB 建立新的資料檔案（例如新的記錄檔或表格空間檔案）時，檔案會完全寫入作業系統快取，然後才刷新到磁碟，這可能會導致一次發生大量的磁碟寫入活動。若要強制從作業系統快取中較小、週期性地刷新資料，您可以使用 innodb_fsync_threshold 變數來定義以位元組為單位的閾值。當達到位元組閾值時，作業系統快取的內容會刷新到磁碟。預設值 0 會強制預設行為，即僅在檔案完全寫入快取後才將資料刷新到磁碟。

在多個 MySQL 執行個體使用相同儲存裝置的情況下，指定閾值以強制較小、週期性的刷新可能會有所幫助。例如，建立新的 MySQL 執行個體及其關聯的資料檔案可能會導致大量的磁碟寫入活動激增，從而影響使用相同儲存裝置的其他 MySQL 執行個體的效能。設定閾值有助於避免寫入活動中的這種激增。

innodb_ft_aux_table

指定包含 FULLTEXT 索引的 InnoDB 表格的完整名稱。此變數用於診斷目的，且只能在執行階段設定。例如：

SET GLOBAL innodb_ft_aux_table = 'test/t1';

在您將此變數設定為 db_name/table_name 格式的名稱之後，INFORMATION_SCHEMA 表格 INNODB_FT_INDEX_TABLE、INNODB_FT_INDEX_CACHE、INNODB_FT_CONFIG、INNODB_FT_DELETED 和 INNODB_FT_BEING_DELETED 會顯示指定表格的搜尋索引相關資訊。

如需更多資訊，請參閱第 17.15.4 節「InnoDB INFORMATION_SCHEMA FULLTEXT 索引表格」。

innodb_ft_cache_size

為 InnoDB FULLTEXT 搜尋索引快取配置的記憶體（以位元組為單位），該快取會在建立 InnoDB FULLTEXT 索引時，將剖析的文件保留在記憶體中。只有在達到 innodb_ft_cache_size 大小限制時，才會將索引插入和更新提交到磁碟。innodb_ft_cache_size 定義每個表格的快取大小。若要設定所有表格的全域限制，請參閱 innodb_ft_total_cache_size。

如需更多資訊，請參閱InnoDB 全文索引快取。

innodb_ft_enable_diag_print

是否啟用其他全文搜尋 (FTS) 診斷輸出。此選項主要用於進階 FTS 偵錯，大多數使用者都不感興趣。輸出會列印到錯誤記錄檔，並包含以下資訊：

innodb_ft_enable_stopword

指定在建立索引時，與 InnoDB FULLTEXT 索引相關聯的一組停用詞。如果設定了innodb_ft_user_stopword_table 選項，則停用詞會從該表格中取得。否則，如果設定了innodb_ft_server_stopword_table 選項，則停用詞會從該表格中取得。若以上皆未設定，則會使用內建的預設停用詞集合。

如需更多資訊，請參閱章節 14.9.4，「全文檢索停用詞」。

innodb_ft_max_token_size

儲存在 InnoDB FULLTEXT 索引中的單字最大字元長度。設定此值的限制可以減少索引的大小，從而加快查詢速度，方法是省略長關鍵字或不是真正單字且不太可能是搜尋詞的任意字母組合。

如需更多資訊，請參閱章節 14.9.6，「微調 MySQL 全文檢索」。

innodb_ft_min_token_size

儲存在 InnoDB FULLTEXT 索引中的單字最小長度。增加此值可以減少索引的大小，從而加快查詢速度，方法是省略在搜尋上下文中不太可能重要的常用單字，例如英文單字 「a」 和 「to」。對於使用 CJK（中文、日文、韓文）字元集的內容，請指定值為 1。

如需更多資訊，請參閱章節 14.9.6，「微調 MySQL 全文檢索」。

innodb_ft_num_word_optimize

在 InnoDB FULLTEXT 索引上每次OPTIMIZE TABLE 操作期間要處理的單字數量。由於對包含全文檢索索引的表格進行大量插入或更新操作可能需要大量的索引維護才能納入所有變更，因此您可能會執行一系列的 OPTIMIZE TABLE 陳述式，每個陳述式都從上一個陳述式結束的地方開始。

如需更多資訊，請參閱章節 14.9.6，「微調 MySQL 全文檢索」。

innodb_ft_result_cache_limit

每個全文檢索查詢或每個執行緒的 InnoDB 全文檢索查詢結果快取限制（以位元組為單位定義）。中間和最終的 InnoDB 全文檢索查詢結果會在記憶體中處理。使用 innodb_ft_result_cache_limit 來對全文檢索查詢結果快取設定大小限制，以避免在非常大的 InnoDB 全文檢索查詢結果（例如數百萬或數億行）的情況下消耗過多的記憶體。當處理全文檢索查詢時，會根據需要分配記憶體。如果達到結果快取大小限制，則會傳回錯誤，指出查詢超出允許的最大記憶體。

所有平台類型和位元大小的 innodb_ft_result_cache_limit 最大值為 2**32-1。

innodb_ft_server_stopword_table

此選項用於指定所有 InnoDB 表格的自訂 InnoDB FULLTEXT 索引停用詞清單。若要為特定 InnoDB 表格設定自訂停用詞清單，請使用 innodb_ft_user_stopword_table。

將 innodb_ft_server_stopword_table 設定為包含停用詞清單的表格名稱，格式為 db_name/table_name。

在設定 innodb_ft_server_stopword_table 之前，停用詞表格必須存在。innodb_ft_enable_stopword 必須啟用，且必須先設定 innodb_ft_server_stopword_table 選項，然後才能建立 FULLTEXT 索引。

停用詞表格必須是 InnoDB 表格，其中包含一個名為 value 的單一 VARCHAR 欄位。

如需更多資訊，請參閱章節 14.9.4，「全文檢索停用詞」。

innodb_ft_sort_pll_degree

在建立搜尋索引時，用於平行索引和標記 InnoDB FULLTEXT 索引中文字的執行緒數量。

如需相關資訊，請參閱章節 17.6.2.4，「InnoDB 全文檢索索引」，以及 innodb_sort_buffer_size。

innodb_ft_total_cache_size

為所有表格的 InnoDB 全文檢索索引快取所配置的總記憶體量（以位元組為單位）。建立許多表格，每個表格都有 FULLTEXT 搜尋索引，可能會消耗大量可用記憶體。innodb_ft_total_cache_size 定義了所有全文檢索索引的整體記憶體限制，以協助避免過度消耗記憶體。如果索引操作達到全域限制，則會觸發強制同步。

如需更多資訊，請參閱InnoDB 全文索引快取。

innodb_ft_user_stopword_table

此選項用於指定特定表格上的自訂 InnoDB FULLTEXT 索引停用詞清單。若要為所有 InnoDB 表格設定自訂停用詞清單，請使用 innodb_ft_server_stopword_table。

將 innodb_ft_user_stopword_table 設定為包含停用詞清單的表格名稱，格式為 db_name/table_name。

在設定 innodb_ft_user_stopword_table 之前，停用詞表格必須存在。innodb_ft_enable_stopword 必須啟用，且必須先設定 innodb_ft_user_stopword_table，然後才能建立 FULLTEXT 索引。

停用詞表格必須是 InnoDB 表格，其中包含一個名為 value 的單一 VARCHAR 欄位。

如需更多資訊，請參閱章節 14.9.4，「全文檢索停用詞」。

innodb_idle_flush_pct

限制 InnoDB 閒置時的頁面刷新。innodb_idle_flush_pct 值是 innodb_io_capacity 設定的百分比，該設定定義了 InnoDB 可用的每秒 I/O 操作數。如需更多資訊，請參閱限制閒置期間的緩衝區刷新。

innodb_io_capacity

innodb_io_capacity 變數定義了 InnoDB 背景工作可用的每秒 I/O 操作數 (IOPS)，例如從緩衝池刷新頁面，以及從變更緩衝區合併資料。

如需有關設定 innodb_io_capacity 變數的資訊，請參閱章節 17.8.7，「設定 InnoDB I/O 容量」。

innodb_io_capacity_max

如果刷新活動落後，InnoDB 可以更積極地刷新，以比 innodb_io_capacity 變數定義更高的每秒 I/O 操作數 (IOPS) 速率。innodb_io_capacity_max 變數定義了在這種情況下 InnoDB 背景工作執行的最大 IOPS 數。此選項不控制 innodb_flush_sync 行為。

預設值是 innodb_io_capacity 值的兩倍。

如需有關設定 innodb_io_capacity_max 變數的資訊，請參閱章節 17.8.7，「設定 InnoDB I/O 容量」。

innodb_limit_optimistic_insert_debug

限制每個B 樹頁面的記錄數。預設值 0 表示不施加限制。只有在使用 WITH_DEBUG CMake 選項編譯偵錯支援時，此選項才可用。

innodb_lock_wait_timeout

一個 InnoDB 交易在放棄之前等待資料列鎖定的時間長度（以秒為單位）。預設值為 50 秒。嘗試存取另一個 InnoDB 交易鎖定的資料列的交易，最多會等待這麼多秒數以取得該資料列的寫入存取權，然後才會發出以下錯誤

ERROR 1205 (HY000): Lock wait timeout exceeded; try restarting transaction

當發生鎖定等待逾時時，目前的陳述式會回滾（而不是整個交易）。若要讓整個交易回滾，請使用 --innodb-rollback-on-timeout 選項啟動伺服器。另請參閱章節 17.20.5，「InnoDB 錯誤處理」。

對於高度互動的應用程式或 OLTP 系統，您可以減少此值，以快速顯示使用者回饋或將更新放入佇列以供稍後處理。對於長時間執行的後端操作，例如資料倉儲中等待其他大型插入或更新操作完成的轉換步驟，您可以增加此值。

innodb_lock_wait_timeout 適用於 InnoDB 的資料列鎖定。MySQL 的資料表鎖定並非發生在 InnoDB 內部，因此這個逾時設定不適用於等待資料表鎖定的情況。

當啟用 innodb_deadlock_detect（預設為啟用）時，鎖定等待逾時值不適用於死結，因為 InnoDB 會立即偵測到死結並回滾其中一個死結交易。當 innodb_deadlock_detect 被停用時，InnoDB 會依賴 innodb_lock_wait_timeout 來在發生死結時回滾交易。請參閱第 17.7.5.2 節，「死結偵測」。

可以使用 SET GLOBAL 或 SET SESSION 陳述式在執行階段設定 innodb_lock_wait_timeout。變更 GLOBAL 設定需要足夠的權限來設定全域系統變數（請參閱第 7.1.9.1 節，「系統變數權限」），並會影響後續連線的所有用戶端的操作。任何用戶端都可以變更 innodb_lock_wait_timeout 的 SESSION 設定，這只會影響該用戶端。

innodb_log_buffer_size

此為 InnoDB 用來寫入磁碟上的日誌檔之緩衝區的大小（以位元組為單位）。預設值為 64MB。較大的日誌緩衝區可以讓大型交易在提交之前，不需要將日誌寫入磁碟即可執行。因此，如果您有更新、插入或刪除許多資料列的交易，將日誌緩衝區放大可以節省磁碟 I/O。如需相關資訊，請參閱記憶體配置和第 10.5.4 節，「最佳化 InnoDB 重做日誌」。如需一般 I/O 調整建議，請參閱第 10.5.8 節，「最佳化 InnoDB 磁碟 I/O」。

innodb_log_checkpoint_fuzzy_now

啟用此偵錯選項，以強制 InnoDB 寫入模糊檢查點。只有在使用 WITH_DEBUG CMake 選項編譯偵錯支援時，才能使用此選項。

innodb_log_checkpoint_now

啟用此偵錯選項，以強制 InnoDB 寫入檢查點。只有在使用 WITH_DEBUG CMake 選項編譯偵錯支援時，才能使用此選項。

innodb_log_checksums

啟用或停用重做日誌頁面的檢查和。

innodb_log_checksums=ON 會啟用重做日誌頁面的 CRC-32C 檢查和演算法。當停用 innodb_log_checksums 時，會忽略重做日誌頁面檢查和欄位的內容。

重做日誌標頭頁面和重做日誌檢查點頁面上的檢查和永遠不會停用。

innodb_log_compressed_pages

指定是否將重新壓縮的頁面映像寫入重做日誌。當變更已壓縮的資料時，可能會發生重新壓縮。

預設啟用 innodb_log_compressed_pages，以防止在還原期間使用不同版本的 zlib 壓縮演算法時可能發生的損毀。如果您確定 zlib 版本不會變更，您可以停用 innodb_log_compressed_pages，以減少修改壓縮資料的工作負載產生的重做日誌。

若要測量啟用或停用 innodb_log_compressed_pages 的影響，請在相同的工作負載下比較兩種設定的重做日誌產生。測量重做日誌產生的選項包括觀察SHOW ENGINE INNODB STATUS 輸出中 LOG 區段的 Log sequence number (LSN)，或監控 Innodb_os_log_written 狀態以查看寫入重做日誌檔案的位元組數。

如需相關資訊，請參閱第 17.9.1.6 節，「OLTP 工作負載的壓縮」。

innodb_log_file_size

這是日誌群組中每個日誌檔的大小（以位元組為單位）。日誌檔的總大小（innodb_log_file_size * innodb_log_files_in_group）不能超過略小於 512GB 的最大值。例如，一對 255 GB 的日誌檔接近限制，但不會超過它。預設值為 48MB。

一般而言，日誌檔的總大小應夠大，讓伺服器可以平滑工作負載活動中的峰值和谷值，這通常表示有足夠的重做日誌空間可以處理超過一小時的寫入活動。此值越大，緩衝池中所需的檢查點刷新活動就越少，從而節省磁碟 I/O。較大的日誌檔也會使損毀復原變得較慢。

innodb_log_file_size 的最小值為 4MB。

如需相關資訊，請參閱重做日誌配置。如需一般 I/O 調整建議，請參閱第 10.5.8 節，「最佳化 InnoDB 磁碟 I/O」。

如果啟用 innodb_dedicated_server，則如果未明確定義 innodb_log_file_size 值，將會自動設定。如需詳細資訊，請參閱第 17.8.12 節，「為專用 MySQL 伺服器啟用自動設定」。

innodb_log_files_in_group

此為日誌群組中日誌檔的數量。InnoDB 會以循環方式寫入檔案。預設（和建議的）值為 2。檔案的位置由 innodb_log_group_home_dir 指定。日誌檔的總大小（innodb_log_file_size * innodb_log_files_in_group）最多可達 512GB。

如需相關資訊，請參閱重做日誌配置。

如果啟用 innodb_dedicated_server，則如果未明確定義 innodb_log_files_in_group，將會自動設定。如需詳細資訊，請參閱第 17.8.12 節，「為專用 MySQL 伺服器啟用自動設定」。

innodb_log_group_home_dir

這是 InnoDB 重做日誌檔案的目錄路徑。

如需相關資訊，請參閱重做日誌配置。

innodb_log_spin_cpu_abs_lwm

定義使用者執行緒在等待刷新重做時不再輪詢的最低 CPU 使用量。該值表示為 CPU 核心使用量的總和。例如，預設值 80 是單一 CPU 核心的 80%。在具有多核心處理器的系統上，值 150 表示一個 CPU 核心的 100% 使用率加上第二個 CPU 核心的 50% 使用率。

如需相關資訊，請參閱第 10.5.4 節，「最佳化 InnoDB 重做日誌」。

innodb_log_spin_cpu_pct_hwm

定義使用者執行緒在等待刷新重做時不再輪詢的最大 CPU 使用量。該值表示為所有 CPU 核心總處理能力的百分比。預設值為 50%。例如，在具有四個 CPU 核心的伺服器上，兩個 CPU 核心的 100% 使用率是組合 CPU 處理能力的 50%。

innodb_log_spin_cpu_pct_hwm 變數會考慮處理器親和性。例如，如果伺服器有 48 個核心，但是 mysqld 程序釘選到只有四個 CPU 核心，則會忽略其他 44 個 CPU 核心。

如需相關資訊，請參閱第 10.5.4 節，「最佳化 InnoDB 重做日誌」。

innodb_log_wait_for_flush_spin_hwm

定義最大平均日誌刷新時間，超過此時間使用者執行緒在等待刷新重做日誌時將不再自旋。預設值為 400 微秒。

如需相關資訊，請參閱第 10.5.4 節，「最佳化 InnoDB 重做日誌」。

innodb_log_write_ahead_size

定義重做日誌的預寫區塊大小，以位元組為單位。為了避免「寫入時讀取」，請將 innodb_log_write_ahead_size 設定為與作業系統或檔案系統快取區塊大小相符。預設設定為 8192 位元組。「寫入時讀取」發生於當重做日誌區塊由於重做日誌的預寫區塊大小與作業系統或檔案系統快取區塊大小不符，而未完全快取至作業系統或檔案系統時。

innodb_log_write_ahead_size 的有效值為 InnoDB 日誌檔案區塊大小 (2ⁿ) 的倍數。最小值為 InnoDB 日誌檔案區塊大小 (512)。當指定最小值時，不會發生預寫。最大值等於 innodb_page_size 值。如果您為 innodb_log_write_ahead_size 指定的值大於 innodb_page_size 值，則 innodb_log_write_ahead_size 設定會被截斷為 innodb_page_size 值。

相對於作業系統或檔案系統快取區塊大小，將 innodb_log_write_ahead_size 值設定得太低會導致「寫入時讀取」。將此值設定得太高可能會對日誌檔案寫入的 fsync 效能產生輕微影響，因為會一次寫入多個區塊。

如需相關資訊，請參閱第 10.5.4 節，「最佳化 InnoDB 重做日誌」。

innodb_log_writer_threads

啟用專用的日誌寫入器執行緒，以將重做日誌記錄從日誌緩衝區寫入到系統緩衝區，並將系統緩衝區刷新到重做日誌檔案。專用的日誌寫入器執行緒可以提高高並發系統的效能，但對於低並發系統，停用專用的日誌寫入器執行緒可提供更好的效能。

有關更多資訊，請參閱第 10.5.4 節，〈最佳化 InnoDB 重做日誌〉。