如何用pg2mysql轻松实现PostgreSQL到MySQL的数据迁移：新手必备指南

pg2mysql 是一款专为PostgreSQL到MySQL数据迁移设计的高效工具，特别适用于处理两种数据库在数据类型（如PostgreSQL的text与MySQL的text差异）和结构上的兼容性问题。通过自动化验证、迁移和校验流程，帮助开发者快速解决跨数据库迁移难题。

📋 核心功能：为什么选择pg2mysql？

pg2mysql的三大核心能力让数据库迁移不再头疼：

• 智能验证：自动检测数据类型兼容性，提前发现潜在迁移风险
• 高效迁移：支持全量数据迁移，可选择清空目标表后导入（--truncate参数）
• 精准校验：迁移后自动对比源库与目标库数据一致性，确保零丢失

🚀 快速上手：3步完成数据库迁移

1️⃣ 环境准备与安装

确保系统已安装Go环境（用于编译源码），然后通过以下命令获取项目：

git clone https://gitcode.com/gh_mirrors/pg2/pg2mysql
cd pg2mysql
make build  # 编译生成可执行文件

2️⃣ 配置文件编写

创建config.yml文件，配置PostgreSQL源库和MySQL目标库信息：

mysql:
  database: target_db
  username: root
  password: your_mysql_password
  host: 127.0.0.1
  port: 3306

postgresql:
  database: source_db
  username: postgres
  password: your_pg_password
  host: 127.0.0.1
  port: 5432
  ssl_mode: disable  # 支持disable/require/verify-full等模式

3️⃣ 执行迁移的完整流程

✅ 第1步：验证数据兼容性

在正式迁移前，先用validate命令检查数据兼容性：

./pg2mysql -c config.yml validate

如果出现类似以下提示，需先处理不兼容数据：

found incompatible rows in apps with IDs [2]
found incompatible rows in events with IDs [16 17 18]

🚚 第2步：执行数据迁移

确认验证通过后，执行迁移命令（添加--truncate参数会清空目标表）：

./pg2mysql -c config.yml migrate --truncate

迁移过程会显示实时进度：

inserted 2 records into droplets
inserted 3 records into organizations
inserted 0 records into service_bindings
...

✅ 第3步：验证迁移结果

迁移完成后，使用verify命令确认数据一致性：

./pg2mysql -c config.yml verify

校验结果示例：

Verifying table spaces_developers...OK
Verifying table droplets...
  FAILED: 1 row missing
  Missing IDs: 1,3,5

💡 进阶技巧：避免90%的迁移坑

数据类型处理最佳实践

PostgreSQL的text类型在MySQL中对应LONGTEXT（而非TEXT），迁移前建议：

• 检查MySQL表结构，将TEXT字段调整为LONGTEXT
• 对超长字符串字段进行截断或拆分处理

时间戳兼容性处理

⚠️ 注意：MySQL和MariaDB对时间戳的处理存在差异：

• 官方MySQL会四舍五入时间戳
• MariaDB会截断时间戳

建议迁移前统一时间戳格式，或在验证阶段重点检查时间字段。

📁 项目结构解析

核心功能模块位于以下路径：

• 迁移核心逻辑：migrator.go
• 数据验证模块：validator.go
• 命令行交互：commands/migrate.go
• 数据库连接配置：config.go

❓ 常见问题解答

Q：迁移时提示"连接拒绝"？
A：检查config.yml中的数据库地址、端口和防火墙设置，确保目标MySQL允许远程连接。

Q：验证通过但迁移后数据不一致？
A：可能是MySQL的字符集设置问题，建议在配置文件中添加charset: utf8mb4参数。

Q：如何只迁移部分表？
A：目前工具支持全库迁移，如需部分迁移，可先导出指定表结构后再执行迁移。

📝 总结

pg2mysql通过验证→迁移→校验的完整流程，有效解决了PostgreSQL到MySQL的数据迁移难题。无论是小型应用还是大型系统，都能通过简单配置快速完成跨数据库迁移。立即尝试，让数据迁移效率提升80%！

提示：迁移前建议备份源数据库，复杂场景下可结合testdata/pgdata.sql和testdata/mysqldata.sql测试数据进行演练。