以下這段文檔是 MySQL 8.0 中關于 innodb_directories 的使用說明，主題為：

如何在 MySQL 服務器離線（關閉）狀態(tài)下安全地移動 InnoDB 表空間文件（如 .ibd、ibdata1、undo 文件等）到新位置。

我們來一步步拆解、解釋和理解這個功能的核心思想與操作流程。

一、核心目標：為什么需要“移動表空間文件”？

在實際運維中，可能會遇到以下場景：

• 原磁盤空間不足，要把某些大表遷移到更大的磁盤；
• 要做數(shù)據歸檔或備份恢復；
• 想優(yōu)化 I/O 性能，把熱點表放到 SSD 上；
• 數(shù)據庫遷移跨平臺（例如從 Windows 到 Linux）；

傳統(tǒng)方式下，移動這些文件后 MySQL 啟動會報錯：“找不到 .ibd 文件”，因為 InnoDB 內部的“數(shù)據字典”仍然記錄著舊路徑。

而 innodb_directories 提供了一個機制：讓 MySQL 在啟動時主動掃描指定目錄，發(fā)現(xiàn)并自動更新這些“被移動”的表空間文件的位置。

二、關鍵變量：innodb_directories

作用：

定義一組額外的目錄，在 MySQL 啟動時由 InnoDB 掃描，用于查找可能已被移動的表空間文件。

它是一個“線索目錄列表”，告訴 MySQL：“去這些地方看看有沒有我丟失的文件。”

 配置語法：

[mysqld]
innodb_directories = "D:/new_tablespace;E:/backup/innodb"

或者命令行啟動：

mysqld --innodb-directories="D:/new_tablespace;E:/backup/innodb"

注意：

• 多個路徑用分號 ; 分隔（Windows/Linux 都可用）
• 使用引號防止 shell 把 ; 當作命令結束符解析

三、自動包含的目錄（無需手動添加）

即使你不設置 innodb_directories，MySQL 總會自動掃描以下三個目錄：

這意味著：

• 如果你只是把 ibdata1 或 undo_001 移到了新的 datadir 下，不需要配置 innodb_directories
• 但如果你把某個 .ibd 文件移到了完全不同的路徑（比如 /ssd/special_table.ibd），就必須把這個路徑加進 innodb_directories

四、工作原理：MySQL 啟動時發(fā)生了什么？

當設置了 innodb_directories 并重啟 MySQL 時，InnoDB 會執(zhí)行以下步驟：

1. 讀取所有配置目錄（包括 innodb_directories + 自動附加的三個目錄）
2. 遞歸掃描每個目錄及其子目錄，尋找 .ibd、ibdata*、undo* 等 InnoDB 表空間文件
3. 對比文件中的 tablespace ID 和數(shù)據字典中記錄的 ID
4. 如果發(fā)現(xiàn)匹配但路徑不同的文件 → 自動更新數(shù)據字典中的路徑！
5. 繼續(xù)正常啟動

結果：文件雖然被移動了，但 MySQL “找到了它”，并且自動修正了元數(shù)據！

失敗情況：如果同一個 tablespace ID 出現(xiàn)在多個位置 → 啟動失?。ǚ罌_突）

五、完整操作流程（官方推薦）

步驟 1??：停止 MySQL 服務

systemctl stop mysql
# 或 Windows:
net stop mysql

必須確保服務器完全關閉，不能有寫入。

步驟 2??：移動文件或目錄

場景 A：移動單個表的 .ibd 文件（file-per-table）

mv /var/lib/mysql/db1/table1.ibd /ssd/fast_storage/db1/

限制：必須放在名為 db1 的目錄下（即 schema 名相同）

場景 B：移動整個 datadir

mv /var/lib/mysql /new_disk/mysql_data

然后要修改 my.cnf 中的 datadir=/new_disk/mysql_data

場景 C：移動 undo 表空間

mv /var/lib/mysql/undo_001 /backup/undo/undo_001

同時需設置：

innodb_undo_directory = /backup/undo

步驟 3??：告知 InnoDB 新位置

情況 1：移動的是普通 .ibd 文件到非標準路徑

[mysqld]
innodb_directories = "/ssd/fast_storage;/backup/tables"

不需要加 datadir、innodb_data_home_dir 等，它們會被自動加入

情況 2：移動了 datadir、ibdata1、undo 文件

只需更新對應配置即可，無需 innodb_directories：

[mysqld]
datadir = /new_disk/mysql_data
innodb_data_home_dir = /new_disk/mysql_data
innodb_undo_directory = /new_disk/mysql_data/undo

步驟 4??：重啟 MySQL

systemctl start mysql

啟動過程中，InnoDB 會掃描所有目錄，找到你的文件，并自動更新內部路徑記錄。

六、重要使用注意事項（Usage Notes）

七、適用對象總結

八、如何查看當前表空間文件位置？

SELECT 
  TABLESPACE_NAME, 
  FILE_NAME,
  ENGINE,
  SPACE_TYPE
FROM INFORMATION_SCHEMA.FILES 
WHERE ENGINE = 'InnoDB'
  AND FILE_NAME LIKE '%.ibd'
ORDER BY TABLESPACE_NAME;

輸出示例：

TABLESPACE_NAME | FILE_NAME
----------------+-----------------------------
sakila/actor    | /ssd/fast_storage/sakila/actor.ibd
test/t1         | /var/lib/mysql/test/t1.ibd

?? 可用來確認文件是否已成功遷移并被識別。

九、最佳實踐建議

十、一句話總結

innodb_directories 是一個“尋人啟事板”：

“MySQL 啟動時，請去這幾個目錄里找找那些‘失蹤’的 .ibd 文件，只要 tablespace ID 對得上，就認回來，并更新它的住址！”

—— 實現(xiàn)了 離線狀態(tài)下安全、自動化地遷移 InnoDB 表空間文件。

補充提示：

如果你經常需要動態(tài)移動表空間，也可以考慮使用 InnoDB General Tablespace（通用表空間），它可以顯式指定路徑，便于集中管理和遷移。

如果你想了解：

• 如何在線遷移表而不停機？
• 如何結合 LVM 快照實現(xiàn)熱遷移？
• 如何避免誤刪導致的數(shù)據丟失？

以上就是MySQL8.0離線遷移表空間的全攻略分享的詳細內容，更多關于MySQL 8.0離線遷移表空間的資料請關注腳本之家其它相關文章！