ibd2sdi必须加--dump-file或重定向，因其默认输出JSON到stdout易被终端截断、乱码或缓冲干扰；--dump-file由工具内部二进制安全写入，确保JSON完整可用，便于jq解析和后续建表转换。
ibd2sdi 是 MySQL 8.0+ 自带的元数据提取工具，它能直接从 .ibd 文件中读取嵌入的 SDI（Serialized Dictionary Information），无需启动 MySQL 服务，也不依赖 .frm 或数据字典表。只要 .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 文件状态或调用方式不满足前提：
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
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）等工具进一步提取。
