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. 典型流程
- 检查源端与目标端版本兼容性、
server_id、二进制日志和 GTID 配置。 - 使用一致性备份或 MySQL Shell 为目标端建立基线数据。
- 配置 GTID 自动定位复制,并开始追赶源库。
- 持续监控复制线程、错误和延迟。
- 切换窗口内停止业务写入,等待目标端应用完全部事务。
- 进行数据校验,将应用连接切换到目标端。
- 保留旧源库为只读状态一段时间,确认稳定后再结束回滚窗口。
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(*) 相同并不能证明数据完全一致。关键表还应使用可靠的校验和工具或按主键分段计算摘要,同时验证视图、触发器、存储程序、事件、账号权限和应用读写。
九、推荐的正式迁移流程
- 盘点环境与依赖,确定迁移方式和成功标准。
- 在测试环境执行完整导出、导入和应用验证。
- 对源库做独立备份,并验证备份可恢复。
- 按迁移方式同步数据,记录开始时间和关键状态。
- 进入切换窗口,停止写入并完成最后同步。
- 校验数据和数据库对象,再切换应用连接。
- 观察错误率、延迟和核心业务指标。
- 在回滚窗口结束前保留旧库,但禁止双写。
十、迁移到其他类型数据库
MySQL 迁移到 PostgreSQL、SQL Server 等异构数据库时,不能直接导入完整的 MySQL SQL 文件。需要转换数据类型、标识符、默认值、函数、索引、存储过程和 SQL 方言,通常使用 ETL 或专用迁移工具,并逐项验证业务逻辑。
十一、官方文档
十二、总结
中小型数据库可使用 mysqldump,较大数据库可使用 MySQL Shell 并行迁移,低停机场景可使用复制完成增量同步和切换。无论选择哪种方式,迁移都应包含备份、演练、校验、监控和回滚方案,而不是只关注导出与导入命令。