技术 · 思考 · 实践 · 成长

首页/MySQL8专栏/正文

MySQL 8 数据库迁移的三种方式:mysqldump、MySQL Shell 与复制迁移

MySQL8专栏761 次阅读

MySQL 8 数据迁移不能简单理解为复制数据库目录。可靠的迁移需要同时考虑数据量、可接受停机时间、源端和目标端版本、存储引擎、账号权限、字符集以及回滚方案。本文介绍三种常用方式:mysqldump 逻辑迁移、MySQL Shell 并行迁移和基于复制的低停机迁移。

一、三种迁移方式如何选择

方式适用场景优点主要限制
mysqldump中小型数据库、允许一定停机通用、直观、便于检查 SQL单文件导入导出速度有限
MySQL Shell Dump/Load数据量较大、希望并行迁移并行、分块、压缩,效率较高需要安装 MySQL Shell 并检查兼容性
复制迁移业务停机窗口很短先持续同步,切换时停机较短搭建和切换更复杂,需要持续监控

如果数据库较小且可以停机,优先使用逻辑备份;数据量较大时考虑 MySQL Shell;要求低停机时,再使用复制迁移。

二、迁移前的检查清单

正式操作前,至少确认以下信息:

  • 源端和目标端的准确版本、操作系统及架构。
  • 数据库大小、最大表、存储引擎和预计迁移时间。
  • 字符集、排序规则、时区和 sql_mode。
  • 表、视图、触发器、存储过程、函数、事件和账号权限。
  • 迁移期间是否允许写入,以及可接受的停机时间。
  • 目标端磁盘空间、参数配置和网络带宽。
  • 校验方法、切换步骤和回滚条件。

可以先收集基础信息:

SELECT VERSION();
SELECT @@character_set_server,
       @@collation_server,
       @@sql_mode,
       @@time_zone,
       @@system_time_zone;

SELECT ENGINE, COUNT(*) AS table_count
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'app_db'
GROUP BY ENGINE;

SELECT ROUND(SUM(DATA_LENGTH + INDEX_LENGTH) / 1024 / 1024, 2) AS size_mb
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'app_db';

三、方式一:使用 mysqldump 迁移

mysqldump 将表结构和数据导出为 SQL,适合中小型数据库。对于以 InnoDB 为主的数据库,可以使用一致性事务减少锁表影响。

1. 导出数据库

mysqldump \
  -h source.example.com \
  -u migration_user \
  -p \
  --single-transaction \
  --quick \
  --routines \
  --events \
  --triggers \
  --hex-blob \
  --default-character-set=utf8mb4 \
  --set-gtid-purged=OFF \
  --databases app_db \
  > app_db.sql
  • -p 后不直接写密码,执行时交互输入,避免密码出现在命令历史和进程参数中。
  • --single-transaction 为 InnoDB 数据提供一致性快照,但不能保证迁移期间变化的 MyISAM 或 MEMORY 表一致。
  • --quick 按行读取大表,减少客户端内存占用。
  • --routines 和 --events 显式包含存储程序与事件;触发器默认包含,这里明确写出便于检查。
  • --set-gtid-purged 应根据目标复制拓扑决定。示例关闭 GTID 信息,不能机械用于所有复制场景。

导出期间应避免对相关表执行 ALTER TABLE、DROP TABLE、TRUNCATE TABLE 等 DDL,否则一致性导出可能失败或产生不符合预期的结果。

2. 检查备份文件

ls -lh app_db.sql
sha256sum app_db.sql
head -n 30 app_db.sql

除文件大小和哈希值外,还应在隔离的测试实例中实际恢复一次。只有成功恢复并通过校验的备份才有意义。

3. 导入目标数据库

mysql \
  -h target.example.com \
  -u migration_user \
  -p \
  --default-character-set=utf8mb4 \
  < app_db.sql

如果导出时未使用 --databases app_db,备份文件可能不包含 CREATE DATABASE 和 USE,此时需要先创建数据库并在导入命令中指定目标库。

4. 不建议直接通过管道迁移生产库

mysqldump -h source.example.com -u migration_user -p app_db \
  | mysql -h target.example.com -u migration_user -p app_db

这种方式虽然简短,但中间没有可重复使用的备份文件,网络中断后也不便排查和重试。生产迁移更推荐先落盘、校验并演练恢复。

四、方式二:使用 MySQL Shell 并行迁移

MySQL Shell 的 util.dumpInstance()、util.dumpSchemas() 和 util.loadDump() 支持并行、分块和压缩,更适合较大的数据集。

1. 导出指定数据库

先连接源端:

mysqlsh --js \
  --host=source.example.com \
  --user=migration_user \
  --password

在 MySQL Shell JavaScript 模式中执行:

util.dumpSchemas(
  ["app_db"],
  "/backup/app_db_dump",
  {
    threads: 4,
    consistent: true,
    compression: "zstd"
  }
);

导出目录必须为空或不存在。线程数应根据源端负载、磁盘和网络能力设置,并非越大越好。

2. 导入目标实例

连接目标端:

mysqlsh --js \
  --host=target.example.com \
  --user=migration_user \
  --password

执行并行加载:

util.loadDump(
  "/backup/app_db_dump",
  {
    threads: 4,
    progressFile: "/backup/app_db-load-progress.json"
  }
);

MySQL Shell 会在转储目录保存元数据,便于检查兼容性和管理加载进度。正式迁移前应使用与目标版本匹配的 MySQL Shell,在测试环境完整演练。

五、方式三:使用复制实现低停机迁移

当数据库较大且停机窗口很短时,可以先把目标服务器配置为源库的副本,让它持续应用增量事务;待延迟归零后短暂停写,再切换应用。

1. 典型流程

  1. 检查源端与目标端版本兼容性、server_id、二进制日志和 GTID 配置。
  2. 使用一致性备份或 MySQL Shell 为目标端建立基线数据。
  3. 配置 GTID 自动定位复制,并开始追赶源库。
  4. 持续监控复制线程、错误和延迟。
  5. 切换窗口内停止业务写入,等待目标端应用完全部事务。
  6. 进行数据校验,将应用连接切换到目标端。
  7. 保留旧源库为只读状态一段时间,确认稳定后再结束回滚窗口。

2. 检查关键配置

SHOW VARIABLES WHERE Variable_name IN (
  'server_id',
  'log_bin',
  'binlog_format',
  'gtid_mode',
  'enforce_gtid_consistency'
);

GTID 可以简化事务定位与故障切换。源端必须具备正确的二进制日志配置,账号应只授予复制所需的最小权限。

3. 查看复制状态

SHOW REPLICA STATUS;

重点检查接收线程和应用线程是否正常、是否存在错误,以及延迟指标。延迟显示为 0 也不能替代业务级数据校验。

4. 切换前停止写入

切换时应由应用进入维护或只读状态,不要只依赖数据库端设置。确认所有事务已同步后,再切换连接配置。旧库应暂时保留且禁止写入,避免新旧两端同时产生数据。

复制搭建涉及账号、网络、证书、GTID 状态和现有拓扑,不能把一段固定命令直接套用到所有环境。生产操作应根据当前实例生成独立的迁移方案。

六、为什么不建议直接复制数据目录

直接复制 /var/lib/mysql 或单独复制表文件,容易遇到数据字典、表空间、重做日志、文件权限和版本兼容问题。即使是 MyISAM 表,也不能把“复制几个文件”当作通用在线迁移方案。

物理迁移应使用 MySQL Enterprise Backup、经过验证的文件系统快照或其他支持该场景的备份工具,并严格遵循一致性、版本和恢复要求。不要在 MySQL 运行期间随意复制数据目录。

七、跨版本迁移注意事项

  • 先阅读官方支持的升级路径和目标版本发行说明。
  • 从 MySQL 5.7 升级到 8.0 前,应先升级到最新的 5.7 GA 版本并执行升级检查。
  • 不支持的跨版本跳跃应分阶段处理,不能仅靠复制数据文件解决。
  • 检查保留字、默认字符集、排序规则、认证插件、sql_mode 和已移除功能。
  • 逻辑导出能降低物理格式差异,但不代表所有 SQL 对象都自动兼容。
  • 先在与生产数据规模接近的测试环境演练,再安排正式窗口。

八、迁移后的数据校验

先比较数据库对象和表数量:

SELECT TABLE_TYPE, COUNT(*) AS object_count
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'app_db'
GROUP BY TABLE_TYPE;

对关键表比较行数、主键范围和业务汇总:

SELECT COUNT(*) AS row_count,
       MIN(id) AS min_id,
       MAX(id) AS max_id,
       SUM(amount) AS total_amount
FROM app_db.orders;

COUNT(*) 相同并不能证明数据完全一致。关键表还应使用可靠的校验和工具或按主键分段计算摘要,同时验证视图、触发器、存储程序、事件、账号权限和应用读写。

九、推荐的正式迁移流程

  1. 盘点环境与依赖,确定迁移方式和成功标准。
  2. 在测试环境执行完整导出、导入和应用验证。
  3. 对源库做独立备份,并验证备份可恢复。
  4. 按迁移方式同步数据,记录开始时间和关键状态。
  5. 进入切换窗口,停止写入并完成最后同步。
  6. 校验数据和数据库对象,再切换应用连接。
  7. 观察错误率、延迟和核心业务指标。
  8. 在回滚窗口结束前保留旧库,但禁止双写。

十、迁移到其他类型数据库

MySQL 迁移到 PostgreSQL、SQL Server 等异构数据库时,不能直接导入完整的 MySQL SQL 文件。需要转换数据类型、标识符、默认值、函数、索引、存储过程和 SQL 方言,通常使用 ETL 或专用迁移工具,并逐项验证业务逻辑。

十一、官方文档

十二、总结

中小型数据库可使用 mysqldump,较大数据库可使用 MySQL Shell 并行迁移,低停机场景可使用复制完成增量同步和切换。无论选择哪种方式,迁移都应包含备份、演练、校验、监控和回滚方案,而不是只关注导出与导入命令。

人生活在得失之间,得亦是失,失亦是得。

评论交流

0 条评论 · 支持多级回复
验证码
暂无评论,来说说你的想法吧

相关文章

继续阅读