MongoDB 在 Ubuntu 上的数据迁移方法
一 方法总览与选择
- 迁移优先考虑使用 MongoDB 官方的二进制备份与恢复工具：mongodump / mongorestore。它们导出为 BSON，能完整保留数据类型、索引与元数据，适合在不同主机或环境间迁移；而 mongoexport / mongoimport（JSON/CSV）更便于与其他系统交互，但存在类型保真度损失，不建议作为主迁移手段。对于副本集/分片集群，可结合 oplog 实现更接近实时的迁移与回放。为降低业务影响，建议在低峰时段执行。
二 同版本迁移步骤（mongodump 与 mongorestore）
- 源端备份
- 安装工具（若未内置）：sudo apt update && sudo apt install -y mongodb-database-tools
- 创建备份目录：sudo mkdir -p /var/backups/mongobackups
- 执行备份（示例为单库）：
- mongodump --db your_db --out /var/backups/mongobackups/$(date +‘%F’)
- 传输到目标机器
- scp -r /var/backups/mongobackups/2025-12-04 user@target_ip:/var/backups/mongobackups/
- 目标端恢复
- 方式 A（推荐，保留库名）：mongorestore --nsInclude your_db.* --drop /var/backups/mongobackups/2025-12-04/your_db
- 方式 B（指定库名恢复）：mongorestore --db your_db --drop /var/backups/mongobackups/2025-12-04/your_db
- 说明
- 使用 –drop 可在恢复前清理目标库，避免集合冲突；如仅需迁移部分集合，可改为 –nsInclude your_db.collection1,your_db.collection2。
- 若源端启用了鉴权，需提供认证参数（如 --uri 或 --username/–password/–authenticationDatabase）。
三 跨版本与跨平台迁移要点
- 基本原则
- 尽量保持 MongoDB 主版本一致（如 5.0 → 6.0），再逐步升级；跨大版本直接恢复可能因存储格式/特性差异失败。
- 使用 BSON 备份 而非 JSON，减少类型丢失风险；恢复后务必校验索引与数据量。
- 升级路径建议
- 先在同版本完成迁移与业务验证，再按官方升级路径逐步升级目标端 MongoDB，随后用 mongorestore 将备份导入新版本。
- 集群与实时性
- 对于副本集，可在备份时使用 –oplog 捕获备份窗口内的变更，在目标端恢复后回放 oplog 达到近实时一致性；分片集群需按分片分别备份并在目标端重建分片拓扑。
四 容器化场景迁移（Docker）
- 若数据卷为 bind mount，直接打包宿主机目录并复制到新主机解压到目标数据目录即可。
- 若使用 named volume，可通过临时容器将卷内容打包/解包：
- 备份：docker run --rm --volumes-from mongo -v /host/backup:/backup ubuntu tar cvf /backup/mongo_data.tar /data/db
- 恢复：docker run --rm --volumes-from mongo -v /host/backup:/backup ubuntu bash -c “cd /data/db && tar xvf /backup/mongo_data.tar --strip 1”
- 注意：直接拷贝数据文件仅适用于停机迁移；运行时拷贝可能导致数据不一致。
五 自动化与运维建议
- 定时备份与清理
- 每日备份：3 3 * * * mongodump --out /var/backups/mongobackups/$(date +‘%F’)
- 清理 7 天前备份：1 3 * * * find /var/backups/mongobackups/ -mtime +7 -exec rm -rf {} ;
- 传输与压缩
- 备份后压缩节省带宽与空间：tar -czvf backup_2025-12-04.tar.gz /var/backups/mongobackups/2025-12-04
- 业务影响与一致性
- 在低峰时段执行，避免大对象迁移导致 WiredTiger 缓存压力；对繁忙库，优先考虑副本集 + oplog 方案以减少停机窗口。