# ibd2sql-main

**Repository Path**: hefeng1987/ibd2sql-main

## Basic Information

- **Project Name**: ibd2sql-main
- **Description**: 如果数据库表坏了，可以使用此项目运行 ibd 后缀的文件，用于恢复数据库
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-17
- **Last Updated**: 2025-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 介绍

[ibd2sql](https://github.com/ddcw/ibd2sql) is tool of transform mysql ibd file to sql(data).

[ibd2sql](https://github.com/ddcw/ibd2sql)是一个使用纯`python3`编写的**离线解析**MYSQL INNODB存储引擎的`ibd文件`的工具. 无第三方依赖包. 使用**GPL-3.0** license.



# 特点

1. **方便**: 提取表DDL
2. **实用**: 可替换库(--schema)/表(--table)名, 可在sql语句中输出完整的字段(--complete)
3. **简单**: 纯python3代码编写, 无依赖包.
4. **支持众多数据类型**: 支持所有mysql数据类型
5. **支持复杂的表结构**: 分区表, 注释, 主键, 外键, 约束, 自增, 普通索引, 前缀索引, 主键前缀索引, 唯一索引, 复合索引, 默认值, 符号, 虚拟字段, INSTANT, 无主键等情况的表
6. **数据误删恢复**: 可以输出被标记为deleted的数据
7. **安全**: 离线解析ibd文件, 仅可读权限即可
8. **支持范围广**: 支持mysql 5.6 or 5.7 or 8.0 or 8.4 or 9.0



测试例子: [docs/ALLTEST.md](https://github.com/ddcw/ibd2sql/blob/main/docs/ALLTEST.md)



# 下载使用

本工具使用纯`python3`编写, 无依赖包, 所以建议直接使用源码.

V1.11 版本下载地址: [https://github.com/ddcw/ibd2sql/archive/refs/tags/v1.11.tar.gz](https://github.com/ddcw/ibd2sql/archive/refs/tags/v1.11.tar.gz)

若要将结果保存到文件, 可使用**重定向**(`python3 main.py xxx.ibd --sql > xxxx.sql`)

## 下载

```shell
wget https://github.com/ddcw/ibd2sql/archive/refs/heads/main.zip
unzip main.zip
cd ibd2sql-main
```

## 使用

**Linux**

```shell
python3 main.py /data/mysql_3314/mysqldata/ibd2sql/ddcw_alltype_table.ibd --sql --ddl
python3 main.py /Users/admin/Desktop/hotdals/i5_rewrite_url_mapping_json.ibd --sql --ddl  >  123.sql
python3 main.py /Users/admin/Desktop/hotdals/i5_rewrite_url.ibd --sql --ddl  >  i5_rewrite_url.sql
```

**Windows**

注意python名字和路径

```shell
python main.py F:\t20240627\test\ddcw_char_ascii.ibd --sql --ddl
```

**WEB控制台查看ibd文件**
```
python3 ibd2sql_web.py /data/mysql_3314/mysqldata/db1/t20241104.ibd
# 然后就使用浏览器方法: http://你的IP:8080  就可以随便点点点了
```

更多使用方法或者5.7环境请看:  [docs/USAGE.md](https://github.com/ddcw/ibd2sql/blob/main/docs/USAGE.md)



# 版本更新

| 版本   | 更新时间       | 说明                     |
| ---- | ---------- | ---------------------- |
| v0.1 | 2023.4.27  | 第一个版本                  |
| v0.2 | 2023.08.30 | 支持更多数据类型               |
| v0.3 | 2023.10.13 | 支持5.7升级到8.0的ibd文件      |
| v1.0 | 2024.01.05 | 支持debug,支持更多类型和功能      |
| v1.1 | 2024.04.12 | 修复一些bug                |
| v1.2 | 2024.04.25 | 新增空间坐标的支持              |
| v1.3 | 2024.05.11 | 支持mysql 5.6, 5.7       |
| v1.4 | 2024.05.21 | 支持溢出页, 子分区             |
| v1.5 | 2024.07.10 | vector and instant BUG |
| v1.6 | 2024.09.19 | 修复一些bug                |
| v1.7 | 2024.10.29 | 1.修复一些bug <br />2.支持压缩页 <br />3.支持drop table的恢复  <br />4.ucs2,utf16,utf32 字符集支持             |
| v1.8    | 2024.11.09 | 1. 支持所有字符集<br />2. 支持kering 插件加密的表 <br />3. 支持web控制台查看数据结构 <br />4. 支持修改lower_case_table_names|
| v1.9    | 2025.02.21 | 修复已知BUG, 支持直接解析5.7的ibd文件|
| v1.10    | 2025.04.16 | 修复已知BUG, 添加快速统计表行数的脚本|
| v1.11    | 2025.06.13 | 修复已知BUG, 设置--foce 为遍历整个数据文件(1. 跳过坏块 2.ibd文件不完整 3. delete page被剔除btree+)|

详情: [docs/CHANGELOG.md](https://github.com/ddcw/ibd2sql/blob/main/docs/CHANGELOG.md)



# 要求和支持范围

要求: python3

支持范围: mysql5.x 8.x 9.x