ra

使用方法

数据库工具
支持binlog数据闪回、binlog转sql等等

支持mysql数据库版本：
5.5.x
5.6.x
5.7.x
8.0.x

binlog转sql例子：
ra tosql --host 127.0.0.1 -u root -p 123456 --start-file mysql-bin.000001

binlog生成恢复sql例子：
ra flashback --host 127.0.0.1 -u root -p 123456 --start-file mysql-bin.000001

解析本地binlog例子：
ra tosql --host 127.0.0.1 -u root -p 123456 --start-file ./mysql-bin.000001 --local

注：解析本地binlog也需要提供数据库信息，用于获取表信息

Usage:
  ra [command]

Available Commands:
  flashback   数据闪回
  help        Help about any command
  tosql       通过binlog日志生成sql

Flags:
  -h, --help      help for ra
  -v, --version   version for ra

Use "ra [command] --help" for more information about a command.

数据闪回（解析出回滚SQL）

Usage:
  ra flashback [flags]

Flags:
  -d, --database string         只解析目标db的sql，多个库用空格隔开，如-d db1 db2。可选。默认支持所有数据库
  -h, --help                    help for flashback
      --host string             数据库host (default "127.0.0.1")
      --only-type strings       只解析指定类型。支持insert,update,delete。多个类型用逗号隔开，如--sql-type insert,delete。可选。默认为增删改都解析 (default [insert,update,delete])
  -p, --password string         数据库密码
  -P, --port int                数据库端口 (default 3306)
      --start-datetime string   起始解析时间'。可选。格式'%Y-%m-%d %H:%M:%S。默认不过滤
      --start-file string       起始解析文件。必须。只需文件名，无需全路径
      --start-position uint32   起始解析位置。可选。默认为start-file的起始位置 (default 4)
      --stop-datetime string    终止解析时间。可选。格式'%Y-%m-%d %H:%M:%S'。默认不过滤
      --stop-file string        终止解析文件。可选。默认为start-file同一个文件
      --stop-position uint32    终止解析位置。可选。默认为stop-file的最末位置
  -t, --tables strings          只解析目标table的sql，多张表用空格隔开，如-t tbl1 tbl2。可选。默认支持所有表，当database配置为空时，支持跨库重名的表
  -u, --username string         数据库用户名

例子：

SHOW BINLOG EVENTS in 'mysql-bin.000011'

+----------------+---+--------------+---------+-----------+------------------------------------+
|Log_name        |Pos|Event_type    |Server_id|End_log_pos|Info                                |
+----------------+---+--------------+---------+-----------+------------------------------------+
|mysql-bin.000011|4  |Format_desc   |1        |126        |Server ver: 8.0.31, Binlog ver: 4   |
|mysql-bin.000011|126|Previous_gtids|1        |157        |                                    |
|mysql-bin.000011|157|Anonymous_Gtid|1        |236        |SET @@SESSION.GTID_NEXT= 'ANONYMOUS'|
|mysql-bin.000011|236|Query         |1        |315        |BEGIN                               |
|mysql-bin.000011|315|Table_map     |1        |438        |table_id: 95 (test.tb_type)         |
|mysql-bin.000011|438|Write_rows    |1        |605        |table_id: 95 flags: STMT_END_F      |
|mysql-bin.000011|605|Xid           |1        |636        |COMMIT /* xid=97 */                 |
+----------------+---+--------------+---------+-----------+------------------------------------+

ra flashback --host 127.0.0.1 -u root -p 123456 --start-file mysql-bin.000011 --start-position 4 --stop-position 636

输出：

delete from `test`.`tb_json` where id = 3 and users = cast('[12,34]' as json) limit 1; # pos 605 timestamp 1682237091

binlog转sql

Usage:
  ra tosql [flags]

Flags:
  -d, --database string         只解析目标db的sql，多个库用空格隔开，如-d db1 db2。可选。默认支持所有数据库
      --ddl                     是否解析ddl语句
  -h, --help                    help for tosql
      --host string             数据库host (default "127.0.0.1")
      --only-type strings       只解析指定类型。支持insert,update,delete。多个类型用逗号隔开，如--sql-type insert,delete。可选。默认为增删改都解析 (default [insert,update,delete])
  -p, --password string         数据库密码
  -P, --port int                数据库端口 (default 3306)
      --start-datetime string   起始解析时间'。可选。格式'%Y-%m-%d %H:%M:%S。默认不过滤
      --start-file string       起始解析文件。必须。只需文件名，无需全路径，local模式时，该参数为文件路径
      --start-position uint32   起始解析位置。可选。默认为start-file的起始位置 (default 4)
      --stop-datetime string    终止解析时间。可选。格式'%Y-%m-%d %H:%M:%S'。默认不过滤
      --stop-file string        终止解析文件。可选。默认为start-file同一个文件
      --stop-position uint32    终止解析位置。可选。默认为stop-file的最末位置
  -t, --tables strings          只解析目标table的sql，多张表用空格隔开，如-t tbl1 tbl2。可选。默认支持所有表，当database配置为空时，支持跨库重名的表
  -u, --username string         数据库用户名

例子：

ra tosql --host 127.0.0.1 -u root -p 123456 --start-file mysql-bin.000011 --start-position 4 --stop-position 636

输出：

insert into `test`.`tb_json` (id, users) values(3, cast('[12,34]' as json)); # pos 605 timestamp 1682237091

感谢

• 本项目参照了 danfengcao/binlog2sql python版本

LICENSE

Copyright 2023 The Ra Authors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0
    
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.