my2sql 安装和配置指南

1. 项目基础介绍和主要编程语言

项目基础介绍

my2sql 是一个用 Go 语言开发的 MySQL binlog 解析工具。它能够解析 MySQL 的 binlog 文件，生成原始 SQL、回滚 SQL、去除主键的 INSERT SQL 等，还可以生成 DML 统计信息以及大事务分析信息。my2sql 主要用于数据快速回滚（闪回）、主从切换后新 master 丢数据的修复、从 binlog 生成标准 SQL 等场景。

主要编程语言

my2sql 使用 Go 语言开发。

2. 项目使用的关键技术和框架

关键技术

• MySQL Binlog 解析：my2sql 能够解析 MySQL 的 binlog 文件，提取其中的 SQL 语句。
• SQL 生成：支持生成原始 SQL、回滚 SQL、去除主键的 INSERT SQL 等。
• DML 统计：可以统计各个表的 DML 操作数量，分析大事务和长事务。

框架

• Go 语言标准库：使用 Go 语言的标准库进行开发。
• 第三方库：依赖于一些开源的 Go 语言库，如 github.com/siddontang/go-mysql 用于解析 binlog。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

1. 安装 Go 语言环境：确保你的系统上已经安装了 Go 语言环境。如果没有安装，可以从 Go 官方网站 下载并安装。
2. 安装 Git：确保你的系统上已经安装了 Git。如果没有安装，可以从 Git 官方网站 下载并安装。
3. MySQL 数据库：确保你有一个可用的 MySQL 数据库实例，并且你有权限访问该实例的 binlog。

安装步骤

步骤 1：克隆 my2sql 项目

首先，你需要从 GitHub 上克隆 my2sql 项目到本地。

git clone https://github.com/liuhr/my2sql.git

步骤 2：进入项目目录

进入克隆下来的 my2sql 项目目录。

cd my2sql

步骤 3：编译项目

使用 Go 语言的编译命令编译 my2sql 项目。

go build

编译完成后，会在当前目录下生成一个名为 my2sql 的可执行文件。

步骤 4：配置 my2sql

my2sql 需要连接到 MySQL 数据库实例来解析 binlog。你需要配置一些参数来指定 MySQL 的连接信息。

创建一个配置文件 config.yaml，内容如下：

mysql:
  host: "127.0.0.1"
  port: 3306
  user: "root"
  password: "your_password"
  binlog:
    start-file: "mysql-bin.000001"
    start-pos: 4
    stop-file: "mysql-bin.000001"
    stop-pos: 583918266

步骤 5：运行 my2sql

使用以下命令运行 my2sql，并指定配置文件路径。

./my2sql -config config.yaml

注意事项

• 权限要求：运行 my2sql 的用户需要有 SELECT、REPLICATION SLAVE、REPLICATION CLIENT 权限。
• MySQL 8.0 配置：如果使用 MySQL 8.0，需要在配置文件中加入 default_authentication_plugin = mysql_native_password，并且用户密码认证必须是 mysql_native_password。

通过以上步骤，你就可以成功安装和配置 my2sql，并开始使用它来解析 MySQL 的 binlog 文件了。