MySQL Binlog解析工具my2sql使用指南与实战教程

时间：2026-08-14 22:43

my2sql 深度解析：从安装到实战，一款高效的MySQL binlog解析工具在MySQL的运维和数据管理工作中，二进制日志（binlog）的地位举足轻重。无论是应对突发的误操作，还是进行日常的变更审计与数据回溯，如何从海量的binlog中精准、高效地提取出可读的SQL语句，始终是DBA和开发者

my2sql 深度解析：从安装到实战，一款高效的MySQL binlog解析工具

在MySQL的运维和数据管理工作中，二进制日志（binlog）的地位举足轻重。无论是应对突发的误操作，还是进行日常的变更审计与数据回溯，如何从海量的binlog中精准、高效地提取出可读的SQL语句，始终是DBA和开发者们绕不开的核心课题。

社区里从来不乏优秀的工具，而近年来，一款用Go语言编写的开源工具——my2sql，凭借其出色的性能和丰富的功能，吸引了众多关注。今天，我们就来深入聊聊这款工具，不仅会手把手带你掌握它的使用方法，还会将其与大家熟悉的binlog2sql做个简要对比，帮你找到最适合自己场景的解决方案。

一、my2sql 是什么？如何安装？

简单来说，my2sql是一个专注于解析MySQL ROW格式binlog的命令行利器。它能将日志中那些“面目模糊”的事件，还原成我们熟悉的原始DML（增删改）或DDL（表结构变更）语句。更妙的是，它还支持生成对应的回滚SQL（即Flashback功能），这在数据误删恢复的场景下，堪称“后悔药”。

它的能力远不止于此，我们来看看它的几大核心特点：

过滤精准：支持按时间、binlog文件、数据库、表名等多个维度进行筛选，直击目标数据。
双向输出：既能输出原始执行SQL，也能生成逆向的回滚SQL，应对不同场景。
兼容性强：完美支持GTID模式下的精确定位，同时解析DML和DDL语句。
部署简单：提供静态编译的二进制文件，开箱即用，无需复杂的依赖环境。
生态友好：开源且持续维护，社区活跃，值得信赖。

1. 使用前提

工欲善其事，必先利其器。在使用my2sql之前，需要确保你的MySQL环境已经做好了以下准备：

首先，MySQL必须开启binlog，并且格式设置为ROW，同时binlog_row_image参数需为full。这通常在my.cnf配置文件中进行设置：

[mysqld]
log-bin = mysql-bin
binlog_format = ROW
binlog_row_image=full
server-id = 1

其次，用于连接数据库的账号需要具备必要的权限，主要是复制相关的权限：

GRANT REPLICATION SLA VE, REPLICATION CLIENT ON *.* TO 'user'@'%';

最后，你得知道目标binlog文件在哪里。通过执行SHOW BINARY LOGS;命令，就能轻松获取到日志文件的列表和路径。

2. 安装方式

my2sql的安装非常灵活，你可以选择从源码编译，也可以直接下载预编译好的二进制包。

(1) 方式一：源码编译安装

这种方式适合喜欢定制或特定系统环境的用户。

① 安装Go环境：这是编译的前提。在CentOS/RHEL系统上，可以这样操作：

yum install -y epel-release
yum install -y go git

安装完成后，别忘了用go version验证一下：

# go version
go version go1.20.12 linux/amd64

② 拉取源码：直接从GitHub仓库克隆项目到本地。

# git clone https://github.com/liuhr/my2sql.git
Cloning into 'my2sql'...
remote: Enumerating objects: 738, done.
remote: Counting objects: 100% (189/189), done.
remote: Compressing objects: 100% (57/57), done.
remote: Total 738 (delta 149), reused 132 (delta 132), pack-reused 549 (from 1)
Receiving objects: 100% (738/738), 25.97 MiB | 10.10 MiB/s, done.
Resolving deltas: 100% (344/344), done.

③ 编译生成：进入源码目录，执行编译命令。

cd my2sql && go build -o my2sql

④ 验证：编译完成后，当前目录下会生成一个名为my2sql的二进制文件。执行./my2sql -V查看版本信息，确认编译成功。

(2) 方式二：二进制包安装

对于追求效率的用户，直接下载预编译好的二进制文件是最快的方式。访问项目的GitHub Releases页面（https://github.com/liuhr/my2sql/blob/master/releases），选择对应系统的包下载即可。例如，对于CentOS 7：

[root@vbox ~]# wget https://github.com/liuhr/my2sql/blob/master/releases/centOS_release_7.x/my2sql
--2026-01-23 01:44:28--  https://github.com/liuhr/my2sql/blob/master/releases/centOS_release_7.x/my2sql
Resolving github.com (github.com)... 20.205.243.166
Connecting to github.com (github.com)|20.205.243.166|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: unspecified [text/html]
Sa ving to: ‘my2sql’
[ <=> ] 184,744      765KB/s   in 0.2s
2026-01-23 01:44:30 (765 KB/s) - ‘my2sql’ sa ved [184744]
[root@vbox ~]# ll -h
total 192K
-rw-------. 1 root root 1.3K Jan 13 20:25 anaconda-ks.cfg
-rw-r--r--  1 root root  943 Jan 22 01:43 deadlock.sh
-rw-r--r--  1 root root 181K Jan 23 01:44 my2sql
[root@vbox ~]# chmod +x my2sql
[root@vbox ~]# ll -h
total 192K
-rw-------. 1 root root 1.3K Jan 13 20:25 anaconda-ks.cfg
-rw-r--r--  1 root root  943 Jan 22 01:43 deadlock.sh
-rwxr-xr-x  1 root root 181K Jan 23 01:44 my2sql
[root@vbox ~]#

下载并赋予执行权限后，运行./my2sql -v检查版本。不过需要提醒一点，根据实测，当前（指文档撰写时）的CentOS 7.9二进制包可能存在运行异常。因此，如果遇到问题，优先推荐采用源码编译的方式，兼容性更有保障。

二、如何使用my2sql

my2sql的所有功能都通过命令行参数组合来驱动，其基本语法结构非常清晰：

./my2sql \
  -host  \
  -port <端口> \
  -user <用户名> \
  -password <密码> \
  -start-file <起始binlog文件> \
  [其他选项]

其中，有几个参数至关重要，它们决定了解析的范围和目标：

-start-file / -stop-file: 指定binlog文件的起止范围。
-start-datetime / -stop-datetime: 按时间范围过滤。
-databases / -tables: 限定只解析特定的数据库或表。
-work-type: 这是核心模式开关，2sql输出原始SQL，rollback则输出回滚SQL。
-output-dir: 指定解析结果的输出目录。

三、实战场景应用示例

了解了基本用法，我们通过两个典型场景来看看my2sql如何大显身手。

1. 场景1：解析指定时间范围binlog，生成执行SQL

假设我们需要审计`testdb`数据库在2026年1月1日上午10点到2月1日上午11点之间的所有数据变更。命令如下：

[root@vbox my2sql]#  ./my2sql -host 127.0.0.1 -port 3306 -user test -password 123456  \
 -start-file mysql-bin.000001   \
 -start-datetime "2026-01-01 10:00:00" \
 -stop-datetime "2026-02-01 11:00:00"   \
 -databases testdb   -work-type 2sql   \
 -output-dir ./

执行后，工具会在指定目录生成包含原始SQL的文件，内容清晰可读，直接反映了这段时间内的所有数据操作。

2. 场景2：解析指定时间范围binlog，生成回滚SQL

这才是my2sql的“高光”功能。当发生误删除或误更新时，我们可以利用它快速生成反向SQL进行恢复。命令与场景1类似，只需将-work-type改为rollback：

[root@vbox my2sql]#  ./my2sql -host 127.0.0.1 -port 3306 -user test -password 123456   -start-file mysql-bin.000001   -start-datetime "2026-01-01 10:00:00" -stop-datetime "2026-02-01 11:00:00"   -databases testdb   -work-type rollback   -output-dir ./
[2026/01/23 03:02:44] [info] binlogsyncer.go:164 create BinlogSyncer with config {1113306 mysql 127.0.0.1 3306 test   utf8 false false  false Local false 0 0s 0s 0 false false 0  0xc0001a8000 0x635100}
...（中间为详细的解析过程日志）
[2026/01/23 03:02:49] [info] events.go:288 exit thread to write redo/rollback sql into file

命令执行后，除了在终端看到详细的解析日志，更关键的是会在输出目录生成一个回滚SQL文件。