binlog2sql
binlog2sql 是一款用於解析 binlog 的工具,
可以從MySQL binlog解析出你要的SQL。
根據不同選項,你可以得到原始SQL、回滾SQL、去除主鍵的INSERT SQL等。
用途
- 數據快速回滾(閃回)
- 主從切換後新master丟數據的修復
- 從binlog生成標準SQL,帶來的衍生功能
環境
- Python 2.7, 3.4+
- MySQL 5.6, 5.7
MySQL server必須設置以下參數:
[mysqld]
server_id = 1
log_bin = /var/log/mysql/mysql-bin.log
max_binlog_size = 1G
binlog_format = row
binlog_row_image = full
user需要的最小權限集合:
select, super/replication client, replication slave
建議授權
GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO
權限說明
- select:需要讀取server端information_schema.COLUMNS表,獲取表結構的元信息,拼接成可視化的sql語句
- super/replication client:兩個權限都可以,需要執行'SHOW MASTER STATUS', 獲取server端的binlog列表
- replication slave:通過BINLOG_DUMP協議獲取binlog內容的權限
安裝
# 安裝git shell> yum install -y git
# 安裝pip工具
shell> yum install -y epel-release shell> yum install -y python-pip # 安裝binlog2sql shell> git clone https://github.com/danfengcao/binlog2sql.git && cd binlog2sql shell> pip install -r requirements.txt
基本用法
解析出標準SQL
shell> python binlog2sql.py -h127.0.0.1 -P3306 -uadmin -p'admin' -dtest -t test3 test4 --start-file='mysql-bin.000002' 輸出: INSERT INTO `test`.`test3`(`addtime`, `data`, `id`) VALUES ('2016-12-10 13:03:38', 'english', 4); #start 570 end 736 UPDATE `test`.`test3` SET `addtime`='2016-12-10 12:00:00', `data`='中文', `id`=3 WHERE `addtime`='2016-12-10 13:03:22' AND `data`='中文' AND `id`=3 LIMIT 1; #start 763 end 954 DELETE FROM `test`.`test3` WHERE `addtime`='2016-12-10 13:03:38' AND `data`='english' AND `id`=4 LIMIT 1; #start 981 end 1147
解析出回滾SQL
shell> python binlog2sql.py --flashback -h127.0.0.1 -P3306 -uadmin -p'admin' -dtest -ttest3 --start-file='mysql-bin.000002' --start-position=763 --stop-position=1147 輸出: INSERT INTO `test`.`test3`(`addtime`, `data`, `id`) VALUES ('2016-12-10 13:03:38', 'english', 4); #start 981 end 1147 UPDATE `test`.`test3` SET `addtime`='2016-12-10 13:03:22', `data`='中文', `id`=3 WHERE `addtime`='2016-12-10 12:00:00' AND `data`='中文' AND `id`=3 LIMIT 1; #start 763 end 954
選項
mysql連接配置
-h host; -P port; -u user; -p password
解析模式
--stop-never 持續解析binlog。可選。默認False,同步至執行命令時最新的binlog位置。
-K, --no-primary-key 對INSERT語句去除主鍵。可選。默認False
-B, --flashback 生成回滾SQL,可解析大文件,不受內存限制。可選。默認False。與stop-never或no-primary-key不能同時添加。
--back-interval -B模式下,每打印一千行回滾SQL,加一句SLEEP多少秒,如不想加SLEEP,請設爲0。可選。默認1.0。
解析範圍控制
--start-file 起始解析文件,只需文件名,無需全路徑 。必須。
--start-position/--start-pos 起始解析位置。可選。默認爲start-file的起始位置。
--stop-file/--end-file 終止解析文件。可選。默認爲start-file同一個文件。若解析模式爲stop-never,此選項失效。
--stop-position/--end-pos 終止解析位置。可選。默認爲stop-file的最末位置;若解析模式爲stop-never,此選項失效。
--start-datetime 起始解析時間,格式'%Y-%m-%d %H:%M:%S'。可選。默認不過濾。
--stop-datetime 終止解析時間,格式'%Y-%m-%d %H:%M:%S'。可選。默認不過濾。
對象過濾
-d, --databases 只解析目標db的sql,多個庫用空格隔開,如-d db1 db2。可選。默認爲空。
-t, --tables 只解析目標table的sql,多張表用空格隔開,如-t tbl1 tbl2。可選。默認爲空。
--only-dml 只解析dml,忽略ddl。可選。默認False。
--sql-type 只解析指定類型,支持INSERT, UPDATE, DELETE。多個類型用空格隔開,如--sql-type INSERT DELETE。可選。默認爲增刪改都解析。用了此參數但沒填任何類型,則三者都不解析。
實際案例
模擬刪除部分數據後,需要緊急回滾
# 創建測試表 create table test1( `id` int(10) primary key AUTO_INCREMENT, `name` varchar(255) NOT NULL, `age` int DEFAULT 0, `created` datetime DEFAULT NULL )ENGINE=InnoDB DEFAULT CHARSET=utf8; # 插入3條數據 insert into test1(`name`, `age`, `created`) values('小明', 25, '2021-10-05 22:51:00'); insert into test1(`name`, `age`, `created`) values('小華', 29, '2021-10-05 22:52:00'); insert into test1(`name`, `age`, `created`) values('小陳', 20, '2021-10-05 22:53:00');
# 模擬刪除部分數據
delete from test1 where id > 2;
開始回滾
# 找出日誌
show master status;
# 解析出標準SQL,用於定位回滾的開始和結束位置 python binlog2sql.py -h127.0.0.1 -P3306 -uroot -p123456 -dtest_rollback -t test1 --sql-type DELETE --start-file='bin-log.000004'
雖然我指定了只解析DELETE語句,但還是把DDL給解析出來了
解析出回滾SQL
python binlog2sql.py -h127.0.0.1 -P3306 -uroot -p123456 --flashback -dtest_rollback -t test1 --sql-type DELETE --start-file='bin-log.000004'
# 解析出來的 SQL INSERT INTO `test_rollback`.`test1`(`id`, `name`, `age`, `created`) VALUES (3, '小陳', 20, '2021-10-05 22:53:00'); #start 1754 end 1967 time 2021-10-05 23:11:39
將上面解析出來的回滾SQL執行一遍即可
使用 binlog2sql 最大的好處就是解析出來的SQL語句非常直觀,並且在註釋中還包含了時間,這對於我們去查找故障發生點非常實用。想一想之前用過的mysqlbinlog工具,解析出來的結果中含有大量無關的信息,爲我們排查問題增加了難度,而binlog2sql解析出來的SQL非常乾淨,便於我們排查問題,恢復數據。
其他案例:
參考鏈接:
https://www.cnblogs.com/lijiaman/p/12770397.html
https://github.com/danfengcao/binlog2sql
https://www.cnblogs.com/lijiaman/p/12770415.html