云数据库 MongoDB：使用MongoDB工具将MongoDB Atlas迁移至阿里云

注意事项

• 确保安装的Mongodump和Mongorestore软件版本与MongoDB Atlas数据库的版本一致。安装步骤请参见官方文档Install MongoDB。
• MongoDB实例支持的版本与存储引擎请参见版本及存储引擎，如需跨版本或跨引擎迁移，请提前确认兼容性。
• 通过MongoDB工具迁移MongoDBAtlas数据库为全量数据迁移。为保障数据一致性，迁移操作开始前请停止源库的相关业务，并停止数据写入。
• 执行mongodump备份命令将覆盖dump文件夹中的历史备份文件。如果您之前使用mongodump命令对源库执行过备份操作，请将dump文件夹中的备份文件移动至其他目录并确保dump文件夹为空。
• 必须在安装有MongoDB数据库的服务器上执行mongodump和mongorestore命令，而不是在Mongo Shell环境下执行。

数据库账号权限要求

准备工作

在阿里云MongoDB管理控制台完成以下准备工作：

1. 创建阿里云MongoDB实例，详情请参见创建副本集实例或创建分片集群实例。
   说明

   • 阿里云MongoDB实例的存储空间要大于MongoDB Atlas的存储空间。
   • 如需迁移至阿里云MongoDB分片集群实例，建议对数据进行分片，详情请参见设置数据分片。
2. 设置阿里云MongoDB实例的数据库密码，详情请参见重置密码。
   说明 如果您在创建实例时设置了数据库密码，可跳过本步骤。

在本地设备上成以下准备工作：

1. 安装MongoDB数据库，详情请参见安装MongoDB。
   说明

   • 该设备仅作为数据备份与恢复的临时中转平台，迁移操作完成后不再需要。
   • 备份目录所在分区的可用磁盘空间要大于MongoDB Atlas数据库的已用存储空间。
2. 将本地设备的公网IP地址加入至阿里云MongoDB实例的白名单中，详情请参见设置白名单。

操作步骤

1. 登录MongoDB Atlas数据库控制台。
2. 将用于数据迁移的本地设备的公网IP地址，加入至MongoDB Atlas实例的白名单中。
3. 在Clusters页面，单击 Clusters 的名称。
4. 在Command Line Tools页签，单击mongodump命令后的COPY，复制包含MongoDB Atlas数据库连接信息的mongodump命令。
5. 在本地设备上，备份MongoDB Atlas数据库。
   1. 在本地设备上，粘贴包含MongoDB Atlas数据库连接信息的mongodump命令。
   2. 将<PASSWORD>替换为所使用的数据库账号密码，将<DATABASE>替换为要备份的数据库名称。
   3. 执行该命令，等待数据备份完毕。
6. 登录阿里云MongoDB控制台，获取阿里云MongoDB实例的公网连接地址。
   • 如要迁移至阿里云MongoDB副本集实例，请获取Primary节点公网连接地址，详情请参见副本集实例连接说明。
   • 如要迁移至阿里云MongoDB分片集群实例，请获取任一Mongos节点的公网连接地址，详情请参见分片集群实例连接说明。
   说明 公网连接地址需要手动申请，详情请参见申请公网连接地址。
7. 在本地设备上，执行以下命令将数据库数据导入至阿里云MongoDB数据库。

   mongorestore --host <mongodb_host>:3717 --authenticationDatabase admin -u <username> -d <database> <database_backupfile_directory>

   说明

   • <mongodb_host>：阿里云MongoDB副本集实例的Primary节点或阿里云MongoDB分片集群实例的Mongos节点连接地址。
   • <username>：阿里云MongoDB实例的数据库账号，本文以test为示例账号。
   • <database>：需要恢复的数据库。备份文件中如有多个数据库，需要重复本步骤进行其它数据库的恢复。
   • <database_backupfile_directory>：数据库备份文件所在的目录。

   示例：

   恢复数据库备份文件中的mongodbtest数据库

   mongorestore --host dds-bp**********-pub.mongodb.rds.aliyuncs.com:3717 --authenticationDatabase admin -u test -d mongodbtest /dump/mongodbtest

   恢复数据库备份文件中的test123数据库

   mongorestore --host dds-bp**********-pub.mongodb.rds.aliyuncs.com:3717 --authenticationDatabase admin -u test -d test123 /dump/test123

8. 当命令行提示 Enter password:时，输入阿里云MongoDB数据库账号对应的密码并按回车键确认。

等待数据恢复完成，MongoDB Atlas数据库即迁移至阿里云MongoDB数据库中。