使用教程：binlog2sql 开源项目

1. 项目目录结构及介绍

- binlog2sql
  ├── README.md    # 项目简介和指南
  ├── binlog2sql.py   # 主要的binlog解析脚本
  ├── requirements.txt  # 必要的依赖库列表
  └── tests           # 测试用例和相关资源
     ├── test_binlog2sql.py 
     └── fixtures            # 示例binlog文件和其他测试数据

binlog2sql项目的主要部分是binlog2sql.py脚本，它负责解析MySQL的binlog文件并转换成可读的SQL语句。requirements.txt列出了所有必要的Python包，用于确保正确安装环境。tests目录包含了测试代码和模拟binlog文件，用于验证工具的功能。

2. 项目启动文件介绍

主要启动文件是binlog2sql.py。可以通过运行下面的命令来使用这个脚本：

python binlog2sql.py [options]

其中，options是各种参数，如MySQL服务器的详细信息、binlog文件路径以及解析选项。一些常用的命令行选项包括：

• -h, --host: MySQL服务器的主机名或IP。
• -u, --user: 连接MySQL的用户名。
• -p, --password: 密码，如果不提供会提示输入。
• -d, --database: 数据库名称。
• -t, --table: 需要解析的表名。
• --sql-type: 指定要解析的SQL类型，比如insert, update, delete等。

3. 项目配置文件介绍

虽然binlog2sql本身没有明确的配置文件，但为了正常使用，您需要在MySQL服务器上进行相应的配置。在my.cnf配置文件中，添加以下行来启用binlog并设置相关参数：

[mysqld]
server_id = 1
log_bin = /var/log/mysql/mysql-bin.log
max_binlog_size = 1G
binlog_format = ROW
binlog_row_image = FULL

上述配置启用了二进制日志功能，设置了日志位置，大小限制以及ROW格式，这对于binlog2sql解析是非常关键的。记得在修改后重启MySQL服务使配置生效。

---

在实践中，您可能还需要基于具体场景调整其他参数，如指定特定的binlog文件或时间范围。参照项目README或使用--help获取更详细的参数说明。