专业级MySQL到PostgreSQL数据迁移开源工具MySQL2PG实战指南

真实案例：某金融公司5000万条数据，30分钟完成迁移，零数据丢失！

数据迁移中常见的坑，你遇到过吗？

痛点	传统方案	结果
表结构转换	手动写 SQL	容易遗漏字段、类型不匹配
数据迁移	用 Navicat 导数据	百万级数据卡死、断连
视图转换	复制粘贴改语法	函数不兼容、跑不通
用户权限	一个个手动重建	权限遗漏、安全漏洞
数据校验	肉眼对比	根本不知道有没有丢数据

如果你还在为这些繁琐且容易出错的手动迁移方式烦恼，那么这篇文章介绍的工具或许能成为你的得力助手。

核心工具登场：MySQL2PG

GitHub 开源地址：https://github.com/xfg0218/MySQL2PG

一句话介绍：这是一个用 Go 语言编写的专业级 MySQL 到 PostgreSQL 迁移工具，主打全自动、高性能、零丢失！

为什么选择MySQL2PG？五大核心优势解析

1. 性能卓越：实现十倍速迁移

传统单线程迁移可能只有约 1000 行/秒的速度，而 MySQL2PG 通过优化，可以达到 10000+ 行/秒。

• 并发引擎：支持 10-50 个线程并发处理迁移任务。
• 批量插入：默认每批 10000 行数据，大幅减少网络 IO 和数据库事务开销。
• 连接池优化：最大支持 100+ 连接，避免了频繁创建和销毁连接带来的性能损耗。

用户反馈：“原本需要 20 小时的迁移，现在 2 小时搞定！”

2. 智能转换：类型与函数精准映射

工具内置了超过 40 种字段类型的智能映射，以及 50+ 个常用函数的自动替换，转换准确率极高。

常见字段类型映射示例：

MySQL	PostgreSQL	说明
int(11)	INTEGER	自动去除长度括号
tinyint(1)	BOOLEAN	智能识别为布尔类型
datetime(6)	TIMESTAMP	保留微秒精度
json	JSON	原生 JSON 类型支持
bigint AUTO_INCREMENT	BIGSERIAL	自增序列完美转换

函数自动替换示例：

-- MySQL 原生语法
SELECT IFNULL(name, 'Unknown') FROM users;

-- 工具自动转换为 PostgreSQL 语法
SELECT COALESCE("name", 'Unknown') FROM "users";

3. 全量迁移：覆盖数据库所有对象

MySQL2PG 支持迁移完整的数据库生态，确保目标库与源库功能一致。

• ✅ 表结构 (DDL)
• ✅ 表数据 (Data)
• ✅ 视图 (Views)
• ✅ 索引 (Indexes)
• ✅ 函数/存储过程 (Functions)
• ✅ 用户 (Users)
• ✅ 表权限 (Privileges)

其完整的迁移流程设计如下：

Step 1: 读取 MySQL 表定义
    ↓
Step 2: 转换表结构（智能类型映射）
    ↓
Step 3: 转换视图（语法适配）
    ↓
Step 4: 同步数据（并发 + 批量）
    ↓
Step 5: 重建索引（主键、唯一、普通）
    ↓
Step 6: 转换函数（50+ 函数映射）
    ↓
Step 7: 迁移用户权限（GRANT 语句）
    ↓
Final: 数据校验（100% 一致性保证）

4. 数据安全：双重校验确保零丢失

• 实时校验：迁移完成后，工具会自动对比 MySQL 和 PostgreSQL 中对应表的行数，并列出任何不一致的表清单。
• 灵活同步策略：支持全量覆盖或增量追加，适应不同场景。

  
  # 全量同步（清空目标表后导入）
  truncate_before_sync: true

增量同步（在目标表数据后追加）

truncate_before_sync: false

#### 5. 操作简单：三步快速上手
整个使用过程非常清晰，对用户友好。

**Step 1：下载并编译**
```bash
git clone https://github.com/xfg0218/mysql2pg.git
cd mysql2pg
make build

Step 2：修改配置文件 config.yml

mysql:
  host: localhost
  port: 3306
  username: root
  password: your_password
  database: source_db

postgresql:
  host: localhost
  port: 5432
  username: postgres
  password: your_password
  database: target_db

conversion:
  options:
    concurrency: 20  # 并发线程数，根据 CPU 调整
    validate_data: true  # 开启数据校验

Step 3：运行迁移命令

./mysql2pg -config config.yml

之后，你只需等待进度条完成即可。

真实用户场景案例

• 案例 1：金融核心系统迁移

  数据量：5000 万条，200+ 张表
  挑战：视图复杂、权限严格、不允许停机
  结果：2 小时完成，零数据丢失，业务无感知

• 案例 2：电商平台分库合并

  场景：8 个 MySQL 分库合并到 1 个 PostgreSQL
  挑战：数据量大、表结构不一致
  结果：利用表过滤功能，分批迁移，顺利上线

• 案例 3：开发环境每日同步

  需求：每天将生产 MySQL 同步到测试 PostgreSQL
  方案：配置增量同步 + 定时任务
  结果：完全自动化，解放 DBA 双手

高级配置与玩法

工具提供了丰富的配置选项，以满足更复杂的迁移需求。

玩法 1：只迁移部分表

conversion:
  options:
    use_table_list: true
    table_list: [users, orders, products]  # 只迁移这 3 张表

玩法 2：排除特定表

conversion:
  options:
    exclude_use_table_list: true
    exclude_table_list: [logs, temp_data]  # 跳过这 2 张表

玩法 3：仅测试连接（用于验证配置）

mysql:
  test_only: true  # 只测试连接，不执行迁移
postgresql:
  test_only: true

玩法 4：字段名统一转为小写

conversion:
  options:
    lowercase_columns: true  # MySQL 的 userName → PostgreSQL 的 username

技术特性对比

功能	MySQL2PG	Navicat	手动脚本
自动类型映射	✅ 40+ 种	⚠️ 部分	❌ 自己写
并发迁移	✅ 支持	❌ 单线程	⚠️ 需开发
视图转换	✅ 自动	❌ 不支持	❌ 手动改
函数转换	✅ 50+ 个	❌ 不支持	❌ 手动改
用户权限迁移	✅ 完整支持	⚠️ 部分	❌ 手动重建
数据校验	✅ 自动	❌ 不支持	❌ 自己写
开源免费	✅ Apache-2.0	❌ 收费	✅ 免费

快速开始配置文件模板

以下是一个功能齐全的 config.yml 模板，你可以直接复制使用并根据实际情况修改。

# ==========================================
# MySQL2PG 配置文件模板
# ==========================================

mysql:
  host: "127.0.0.1"
  port: 3306
  username: "root"
  password: "your_mysql_password"
  database: "source_database"
  max_open_conns: 100
  max_idle_conns: 50
  connection_params: "charset=utf8mb4&parseTime=true"

postgresql:
  host: "127.0.0.1"
  port: 5432
  username: "postgres"
  password: "your_pg_password"
  database: "target_database"
  max_conns: 50

conversion:
  options:
    # 迁移步骤控制（true=执行，false=跳过）
    tableddl: true          # 表结构
    data: true              # 表数据
    view: true              # 视图
    indexes: true           # 索引
    functions: true         # 函数
    users: true             # 用户
    table_privileges: true  # 表权限

    # 性能优化
    concurrency: 20                 # 并发线程数
    batch_insert_size: 10000        # 每批插入行数
    max_rows_per_batch: 100000      # 每批读取行数

    # 数据安全
    validate_data: true             # 同步后校验
    truncate_before_sync: true      # 同步前清空表

    # 其他选项
    lowercase_columns: true         # 字段名转小写
    skip_existing_tables: false     # 跳过已存在的表

项目资源与支持

资源	链接
GitHub 仓库	https://github.com/xfg0218/MySQL2PG
详细文档	见仓库中的 README.md
问题反馈	GitHub Issues
技术交流	GitHub Discussions

结语

数据库迁移是一项严谨且风险较高的工作。一次失败的迁移可能导致数据丢失、业务中断等严重后果。一个可靠的工具能极大降低风险，提升效率。

MySQL2PG 作为一款专注且成熟的 开源实战 项目，在 数据库 迁移领域提供了强大的自动化支持，能帮助你：

• 省时：将迁移周期从几天缩短到几小时。
• 省心：全自动化流程，无需全程紧盯。
• 省力：简单配置，一键执行。

如果你正计划或正在进行从 MySQL 到 PostgreSQL 的迁移，不妨尝试一下这个工具，它很可能会成为你顺利完成迁移任务的“利器”。