真或假的系統變數可以在伺服器啟動時透過命名啟用，或使用 --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 選項中指定的最大值。此值表示微秒數。此選項在繁忙的系統中非常有用，具有超過 16 個 InnoDB 線程。（實際上，它對於具有數百或數千個同時連線的 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 的值。可以 1MB (1048576 位元組) 為單位增加或減少 innodb_buffer_pool_chunk_size。

變更 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 的組合，以使每個緩衝池執行個體至少為 1 GB。

如果 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 位元區塊，這比一次掃描 8 位元區塊的 innodb 檢查碼演算法快。值 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 的值，預設行為是建立一個名為 ibdata1 的單一自動擴展資料檔案，其大小略大於 12MB。

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

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

檔案大小以千位元組、百萬位元組或十億位元組指定，方法是在大小值後附加 K、M 或 G。如果以千位元組指定資料檔案大小，請以 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 於啟動時建立要掃描的目錄列表時，總是會附加到 innodb_directories 參數值。無論是否明確指定 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 會弄髒指定的頁面。只有在使用 WITH_DEBUG CMake 選項編譯偵錯支援時，才能使用 innodb_fil_make_page_dirty_debug 選項。

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 合規性與當重新排列並分批完成與提交相關的 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 可以更積極地刷新，其每秒 I/O 操作次數 (IOPS) 高於 innodb_io_capacity 變數所定義的值。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 節，「死結偵測」。

innodb_lock_wait_timeout 可以在執行時使用 SET GLOBAL 或 SET SESSION 陳述式進行設定。變更 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

定義使用者執行緒在等待 redo 記錄刷新時，不再自旋 (spin) 等待的最大平均日誌刷新時間。預設值為 400 微秒。

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

innodb_log_write_ahead_size

定義 redo 日誌的預寫區塊大小，以位元組為單位。為避免「寫入時讀取」(read-on-write)，請將 innodb_log_write_ahead_size 設定為符合作業系統或檔案系統快取區塊大小。預設設定為 8192 位元組。當 redo 日誌區塊因 redo 日誌的預寫區塊大小與作業系統或檔案系統快取區塊大小不符，而未完全快取至作業系統或檔案系統時，就會發生寫入時讀取。

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

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

如需更多資訊，請參閱第 10.5.4 節，"最佳化 InnoDB Redo 日誌"。

innodb_lru_scan_depth

一個影響 InnoDB 緩衝池 刷新 操作的演算法和啟發式方法的參數。主要用於效能專家調整 I/O 密集型工作負載。它指定每個緩衝池實例，頁面清理器執行緒掃描緩衝池 LRU 頁面列表多深以尋找要刷新的髒頁面。這是每秒執行一次的背景操作。

小於預設值的設定通常適用於大多數工作負載。大於必要的值可能會影響效能。只有在典型工作負載下有備用的 I/O 容量時，才考慮增加該值。相反地，如果寫入密集型工作負載使 I/O 容量飽和，請減小該值，尤其是在大型緩衝池的情況下。

在調整 innodb_lru_scan_depth 時，從較低的值開始，然後向上配置設定，目標是很少看到零個可用頁面。此外，由於 innodb_lru_scan_depth * innodb_buffer_pool_instances 定義頁面清理器執行緒每秒執行的工作量，因此在變更緩衝池實例的數量時，請考慮調整 innodb_lru_scan_depth。

如需相關資訊，請參閱第 17.8.3.5 節，"設定緩衝池刷新"。如需一般 I/O 調整建議，請參閱第 10.5.8 節，"最佳化 InnoDB 磁碟 I/O"。

innodb_max_dirty_pages_pct

InnoDB 會嘗試從緩衝池刷新資料，以便髒頁面的百分比不超過此值。