MongoDB数据迁移至Debian流程

MongoDB数据迁移至Debian流程

一、准备工作

1. 确认源与目标环境状态：确保源MongoDB实例（任意操作系统）和目标Debian服务器均已启动并正常运行；目标Debian系统需联网以下载MongoDB工具及依赖。
2. 安装MongoDB工具包：在目标Debian服务器上安装mongodb-clients包（包含mongodump、mongorestore等工具），执行命令：
   sudo apt update && sudo apt install -y mongodb-clients。
3. 创建备份目录：在目标服务器上创建专用目录用于存放备份文件，避免权限问题：
   sudo mkdir -p /backup/mongodb。

二、源数据库备份

使用mongodump工具备份源数据库数据，支持全库或指定集合备份。示例如下：

• 全库备份：sudo mongodump --host <source_host> --port <source_port> --username <username> --password <password> --authenticationDatabase admin --out /backup/mongodb/$(date +%Y%m%d%H%M%S)；
• 指定数据库备份：添加--db <source_db>参数；
• 指定集合备份：添加--collection <collection_name>参数。
  注：<source_host>、<source_port>、<username>、<password>需替换为源MongoDB的实际信息；$(date +%Y%m%d%H%M%S)用于生成时间戳目录，便于版本管理。

三、备份文件传输

将目标服务器上的备份文件传输至Debian服务器，推荐使用scp（安全拷贝）或rsync（增量同步）工具：

• scp传输：scp -r /backup/mongodb/<timestamp_directory> <debian_user>@<debian_ip>:/path/to/debian/destination；
• rsync传输：rsync -avz --progress /backup/mongodb/<timestamp_directory> <debian_user>@<debian_ip>:/path/to/debian/destination。
  注：<debian_user>为Debian服务器的用户名，<debian_ip>为其IP地址，<timestamp_directory>为备份目录名称。

四、目标数据库恢复

登录Debian服务器，使用mongorestore工具将备份数据导入目标MongoDB实例：

• 全库恢复：sudo mongorestore --host <target_host> --port <target_port> --username <target_username> --password <target_password> --authenticationDatabase admin /path/to/debian/destination/<timestamp_directory>/<source_db>；
• 指定数据库恢复：添加--db <target_db>参数（可覆盖同名数据库）；
• 指定集合恢复：添加--collection <target_collection>参数（可覆盖同名集合）。
  注：若目标数据库不存在，mongorestore会自动创建；若需保留现有数据，可添加--noOverwrite参数（避免覆盖同名文档）。

五、验证数据完整性

1. 连接目标数据库：在Debian服务器上启动MongoDB shell：mongo --host <target_host> --port <target_port> --username <target_username> --password <target_password> --authenticationDatabase admin；
2. 检查集合与数据：切换至目标数据库，列出所有集合并查询数据：

   use <target_db>;
   show collections;
   db.<collection_name>.find().pretty();
   

   确认集合数量、文档结构及数据内容与源数据库一致。

六、注意事项

1. 版本兼容性：确保源与目标MongoDB版本兼容（如源为5.0，目标可为5.0及以上，但高版本向低版本迁移可能存在功能限制），建议参考MongoDB官方版本兼容矩阵。
2. 数据一致性：迁移前停止源数据库的写入操作（或开启事务），避免迁移过程中数据变更导致不一致；传输过程中使用scp（加密）或rsync（校验）确保文件完整性。
3. 权限配置：目标MongoDB需开启身份验证（security.authorization: enabled），并确保迁移用户具有read（源）和readWrite（目标）权限；若需远程访问，修改/etc/mongod.conf中的bindIp为0.0.0.0（或指定IP），并开放27017端口（sudo ufw allow 27017）。
4. 性能优化：大数据量迁移时，可使用mongodump的--gzip参数压缩备份文件（减少传输时间），或mongorestore的--numParallelCollections参数并行恢复集合（提升恢复速度）。
5. 应用适配：迁移完成后，更新应用程序的数据库连接配置（如主机地址、端口、数据库名、认证信息），并进行全面功能测试（如CRUD操作、索引查询），确保应用正常运行。