MySQL到PostgreSQL一站式迁移实战指南：从配置到落地全攻略

评估迁移需求：何时选择mysql-to-postgres

迁移决策矩阵

需求场景	推荐指数	关键考量因素
全量数据迁移	★★★★★	表结构复杂度、数据量大小
增量同步	★★★☆☆	时间窗口限制、业务连续性要求
复杂数据类型转换	★★★★☆	JSON/Geometry等特殊类型处理需求
跨版本迁移	★★★★☆	MySQL版本兼容性、PostgreSQL特性
异构架构迁移	★★★☆☆	索引策略调整、约束重定义

[!TIP] 当你的项目需要利用PostgreSQL的高级特性（如JSONB、窗口函数、GIS支持），或面临MySQL性能瓶颈时，mysql-to-postgres将是理想选择。

规划迁移策略：核心功能与架构解析

1. 工具工作原理

mysql-to-postgres采用"读写分离"架构，通过三个核心组件协同工作：

• MySQL Reader：读取源数据库结构与数据（类比为"数据采集器"）
• Converter：核心协调器，处理类型转换与数据映射（类比为"数据翻译官"）
• PostgreSQL Writer：负责目标数据库写入与结构创建（类比为"数据构建师"）

2. 迁移流程解析

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  MySQL数据库  │────▶│  转换引擎    │────▶│ PostgreSQL数据库│
└─────────────┘     └─────────────┘     └─────────────┘
     │                    │                    │
     ▼                    ▼                    ▼
读取表结构             类型映射转换           创建表结构
读取数据记录           数据清洗转换           写入数据记录
                      生成索引约束           创建索引约束

配置最佳实践：打造个性化迁移方案

1. 环境准备

# 源码安装方式
git clone https://gitcode.com/gh_mirrors/my/mysql2postgres
cd mysql2postgres
bundle install
gem build mysqltopostgres.gemspec
gem install mysqltopostgres-0.3.1.gem

2. 配置文件核心参数

创建config/database.yml配置文件，关键配置项说明：

mysql2psql:
  mysql:
    hostname: localhost
    port: 3306
    username: root
    password: your_mysql_password
    database: source_db
  
  destination:
    production:
      adapter: postgresql
      host: pg-server
      database: target_db
      username: postgres
      password: your_pg_password
  
  # 核心控制选项
  tables: ["users", "orders", "products"]  # 指定迁移表
  exclude_tables: ["logs", "temp_data"]    # 排除表
  suppress_data: false                     # 仅迁移结构
  force_truncate: true                     # 清空目标表
  preserve_order: true                     # 按指定顺序迁移
  report_status: json                      # 生成迁移报告

[!WARNING] 首次迁移建议设置force_truncate: false，在测试环境验证数据一致性后再启用该选项。

执行迁移操作：分场景实施指南

1. 基础全量迁移

# 使用默认配置文件执行迁移
mysqltopostgres -c config/database.yml

# 指定环境执行
mysqltopostgres -c config/database.yml -e production

2. 仅结构迁移（无数据）

# 修改配置文件
suppress_data: true
suppress_ddl: false

3. 复杂数据类型处理

针对MySQL特有类型的转换策略：

MySQL类型	PostgreSQL对应类型	转换注意事项
VARCHAR(255)	VARCHAR	自动映射
DATETIME	TIMESTAMPTZ	保留时区信息
ENUM	VARCHAR	建议后续创建CHECK约束
GEOMETRY	GEOMETRY	需要启用PostGIS扩展
JSON	JSONB	自动转换为二进制JSON格式

4. 迁移进度监控

工具提供实时状态反馈：

{
  "status": "in_progress",
  "current_table": "orders",
  "processed_rows": 15420,
  "total_rows": 45680,
  "elapsed_time": "00:15:32"
}

验证与优化：确保迁移质量

1. 数据一致性校验

# 对比表记录数
mysqltopostgres-verify -c config/database.yml --count-only

# 深度数据对比（抽样）
mysqltopostgres-verify -c config/database.yml --sample 1000

2. 性能优化技巧

1. 批量处理调优：调整batch_size参数（默认1000行）
2. 索引策略：迁移后重建索引而非迁移过程中创建
3. 连接池配置：根据服务器配置调整pool参数（建议4-8）
4. 并行迁移：对无关联表采用多进程迁移
5. 数据类型优化：PostgreSQL中使用更精确的类型定义（如INT4替代INT）

3. 常见问题解决方案

• 外键约束问题：使用preserve_order确保父表先迁移
• 大表迁移超时：启用chunk_size参数分片处理
• 字符集冲突：在配置中显式指定encoding: utf8mb4
• 权限问题：确保PostgreSQL用户有CREATE TABLE和COPY权限

迁移后工作：系统平滑过渡

1. 应用适配调整

• 更新数据库连接字符串
• 调整SQL语法差异（如LIMIT位置、字符串连接操作符）
• 替换MySQL特有函数（如NOW() → CURRENT_TIMESTAMP）

2. 性能监控与调优

• 启用PostgreSQL慢查询日志
• 分析执行计划，优化迁移后的查询
• 调整PostgreSQL配置参数（shared_buffers、work_mem等）

3. 回滚预案

保留7天的MySQL数据快照，确保在出现问题时可快速回滚：

# 创建MySQL数据备份
mysqldump -u root -p --all-databases > migration_backup.sql

[!TIP] 建议在业务低峰期执行迁移，预留至少2倍于预估时间的窗口，确保有足够时间处理意外情况。

通过mysql-to-postgres工具，你可以实现从MySQL到PostgreSQL的平稳迁移，充分利用PostgreSQL的强大功能提升应用性能与扩展性。无论是小型应用还是大型企业系统，这套迁移方案都能为你提供可靠、高效的数据库转换体验。