如何通过ibd2sdi工具从MySQL中提取InnoDB元数据信息？

本文共计1102个文字，预计阅读时间需要5分钟。

codeibd2sdi 是 MySQL 8.0 自带的一个元数据提取工具。它用于读取 InnoDB 数据文件（.ibd）并提取有关表结构、索引和行数据的信息。使用这个工具，可以直接输出数据库的元数据，而不需要尝试图形化界面或进行复杂的查询。

---

用 ibd2sdi 提取 SDI 时为什么必须加 --dump-file 或重定向？

ibd2sdi 默认把 JSON 输出到 stdout，但实际使用中容易被截断或混入控制字符（尤其在 Windows CMD 或某些终端里）。不显式指定输出路径，可能导致：

• JSON 不完整（缺结尾大括号）
• 中文字段名乱码（终端编码不匹配）
• 无法后续用 jq 或脚本解析

推荐始终用 --dump-file 显式落盘：

ibd2sdi --dump-file projects_sdi.json /var/lib/mysql/card_system/projects.ibd

而不是：

ibd2sdi /var/lib/mysql/card_system/projects.ibd > projects_sdi.json

原因：--dump-file 由工具内部以二进制安全方式写入，绕过 shell 重定向的编码/缓冲风险。

---

ibd2sdi 解析失败常见报错及对应动作

以下错误不是“工具坏了”，而是 .ibd 文件状态或调用方式不满足前提：

• ibd2sdi: error while loading shared libraries: libmysqlservices.so.21: cannot open shared object file
  → 缺少 MySQL 共享库：把 libmysqlservices.so.21 所在目录（通常是 /usr/lib/mysql/plugin 或 bin/ 同级 lib/）加入 LD_LIBRARY_PATH

• Failed to read SDI from tablespace
  → 可能原因：

  • 该 .ibd 属于临时表或 undo 表空间（ibd2sdi 明确不支持）
  • 文件被 truncate 过（大小小于 16KB，InnoDB 最小页大小）
  • MySQL 正在对该表执行 DDL（如 ALTER TABLE），SDI 处于中间状态

• 输出 JSON 为空数组 [] 或只有 {"id":0,"type":0}
  → 表是 MySQL 5.7 或更早创建、后升级到 8.0，且未重建过（旧格式不存 SDI）；或该 .ibd 来自 general tablespace（需确认是否为 file-per-table）

---

从 projects_sdi.json 中快速定位建表关键字段

SDI JSON 结构嵌套深，不必通读。重点关注以下路径（用 jq 或文本搜索即可）：

• 表名和库名：.objects[].object.name 和 .objects[].object.schema_ref
• 字段列表：.objects[].object.columns，每个元素含 name、type、is_nullable、char_length、column_type_utf8
• 主键信息：.objects[].object.indexes[] | select(.object.index_type == 3)（index_type == 3 表示 CLUSTERED）
• 自增起始值：.objects[].object.next_autoinc
• 字符集与排序规则：.objects[].object.collation_id 需查 MySQL 源码或 information_schema.COLLATIONS 映射（常见：83=utf8mb4_0900_ai_ci）

例如快速提取字段名和类型：

jq -r '.objects[].object.columns[] | "\(.name) \(.column_type_utf8)"' projects_sdi.json

---

导出的 SDI 能直接用来重建表吗？

不能直接 CREATE TABLE，因为 SDI 是内部元数据格式，不是 SQL。你需要人工或脚本转换。最容易踩的坑是：

• column_type_utf8 值如 "int unsigned" 或 "varchar(64)" 可直接用，但 "datetime(3)" 中的精度数字需补全为 DATETIME(3)
• is_auto_increment 为 true 时，记得加 AUTO_INCREMENT，并用 next_autoinc 设置起始值（ALTER TABLE ... AUTO_INCREMENT = 21）
• 索引定义在 .indexes 里，但 index_type、algorithm、is_unique 需映射成 UNIQUE KEY、INDEX 等
• 如果表有外键，SDI 中的 foreign_keys 字段存在但极难反解——此时建议先建无约束表，再手动补 ALTER TABLE ... ADD FOREIGN KEY

真正恢复数据时，ibd2sdi 只解决“结构”问题；数据行本身还得靠 ibd2sql 或 mysqlfrm（仅限 5.7）等工具进一步提取。