my2sql-plus 用于解析 MySQL row binlog,面向 DML 场景生成 SQL、JSON、统计结果,以及可选的反向 binlog 和 rollback summary。

这是一个 row binlog DML 工具。README 不把 DDL 回滚或 statement binlog 作为主能力介绍。

推荐先通过 Makefile 编译,再使用生成的二进制 my2sql。

• 需要读取的是 MySQL row binlog。
• repl 模式需要可连接源库,并使用唯一的 --server-id 以从 binlog 拉流。
• file 模式虽然读取本地 binlog 文件,但当前 SQL / JSON 生成阶段仍会连接 MySQL,通过 SHOW COLUMNS / SHOW INDEX 获取表结构;它不是纯离线模式。
• 需要保证 --output-dir 有足够磁盘空间,尤其是在批量导出 SQL、JSON 和 flashback 文件时。
• 如果要校验 .flashback 文件是否可读,可选安装 mysqlbinlog。

先编译二进制:

make darwin

编译完成后,会得到 bin/my2sql。如果需要 Linux amd64 产物,可使用:

make build

查看版本:

./bin/my2sql version

查看帮助:

./bin/my2sql --help
./bin/my2sql run --help

当前 ./bin/my2sql run --help 会按参数章节输出英文帮助文案,并提供贴近 README 的场景化示例,适合作为终端内快速参考。

file 模式生成 rollback SQL:

./bin/my2sql run \
 --mode=file \
 --work-type=rollback \
 --host=127.0.0.1 \
 --port=3306 \
 --user=root \
 --password=secret \
 --local-binlog-file=/path/to/mysql-bin.000001

repl 模式生成正向 SQL:

./bin/my2sql run \
 --mode=repl \
 --work-type=2sql \
 --host=127.0.0.1 \
 --port=3306 \
 --user=root \
 --password=secret \
 --server-id=223306 \
 --start-file=mysql-bin.000001 \
 --start-pos=4

统计模式:

./bin/my2sql run \
 --mode=file \
 --work-type=stats \
 --host=127.0.0.1 \
 --port=3306 \
 --user=root \
 --password=secret \
 --local-binlog-file=/path/to/mysql-bin.000001 \
 --output-dir=/tmp/my2sql-plus-out

rollback 同时生成 SQL、flashback binlog 和 summary:

./bin/my2sql run \
 --mode=file \
 --work-type=rollback \
 --host=127.0.0.1 \
 --port=3306 \
 --user=root \
 --password=secret \
 --local-binlog-file=/path/to/mysql-bin.000001 \
 --flashback-binlog \
 --flashback-binlog-base=rollback_out \
 --summary \
 --summary-file=rollback-summary.txt

按表拆分文件:

./bin/my2sql run \
 --mode=file \
 --work-type=2sql \
 --host=127.0.0.1 \
 --port=3306 \
 --user=root \
 --password=secret \
 --local-binlog-file=/path/to/mysql-bin.000001 \
 --file-per-table

校验生成的 flashback 文件:

mysqlbinlog rollback_out.flashback

这里的 <type> 以当前 loader 类型为准。对 CLI 来说,常见值是 2sql、rollback、json。

summary 固定包含以下列:

开启后,SQL 文件中的每条 SQL 之前会额外写入一行注释,包含:

• datetime
• database
• table
• binlog
• startpos
• stoppos

这个附加信息只作用于 SQL 文件输出,不作用于 JSON 文件。

• 会把 SQL 结果直接输出到屏幕,而不是落 SQL 文件。
• 这个开关更适合快速查看 SQL 结果。
• 在 2sql / rollback 下,当前实现会同时跑 SQL loader 和 JSON loader,因此屏幕上可能看到重复 SQL 输出。
• 当前实现不会把 JSON 结果以独立 JSON 形式输出到屏幕,因此它不适合作为 JSON 消费方式。
• stats 产物仍然会写入 binlog_status.txt 和 biglong_trx.txt。

• --summary-file 会隐式开启 --summary。
• --flashback-binlog-base 必须和 --flashback-binlog 一起使用。
• --flashback-binlog 和 --summary 只允许在 --work-type=rollback 下使用。
• --flashback-binlog-base 和 --summary-file 如果给的是相对路径,会基于 --output-dir 解析。
• file 模式下如果没显式给 --start-file,当前实现会自动用 --local-binlog-file 的 basename 作为起点 binlog 名。
• 2sql 和 rollback 当前都会额外产出 JSON 文件,不是只产出 SQL。
• --output-toScreen 不能等价替代完整落盘结果。它主要适合快速查看 SQL,当前实现不会把 JSON 单独渲染到屏幕,而且在 2sql / rollback 下可能看到重复 SQL 输出。
• --add-extraInfo 只影响 SQL 文件输出,不影响 JSON 文件,也不会改变当前的屏幕输出格式。
• --do-not-add-prefixDb 名字是否定式开关。默认行为是带数据库前缀,打开它以后才是不带前缀。
• file 模式不是"给一个 binlog 文件就能纯离线出 SQL"。当前实现仍需要连接 MySQL 读取表结构。

• 本项目面向 row binlog 的 DML 处理,不承诺完整支持 statement binlog。
• 不承诺 DDL 回滚能力,也不保证 DDL 穿插时的回滚结果一定安全。
• 当前 SQL / JSON 生成依赖实时获取表结构,因此不承诺"无数据库连接的离线 SQL 生成"。
• README 仅描述当前 CLI 暴露出来的能力,不覆盖未暴露的遗留配置字段。