使用 MongoDB 工具迁移自建数据库上云

本文来自于【阿里云官方镜像站：https://developer.aliyun.com/mirror/?utm_content=g_1000307095 】

原文链接：https://developer.aliyun.com/article/748927?spm=a2c6h.12873581.0.0.54c47e46mLfYep

镜像下载、域名解析、时间同步请点击 阿里巴巴开源镜像站

Mongodump和Mongorestore是MongoDB数据库自带的备份恢复工具。您可以在本地设备或ECS实例中安装MongoDB数据库，然后借助该工具将自建MongoDB数据库迁移至阿里云MongoDB副本集实例。

一、前提条件

请确保安装的Mongodump和Mongorestore软件版本与自建MongoDB数据库的版本一致。安装步骤请参见官方文档Install MongoDB。

说明 您也可以直接在自建MongoDB数据库所属的服务器上执行Mongodump和Mongorestore命令，无需安装。

副本集实例的存储空间应大于自建MongoDB数据库已占用的存储空间。如存储空间不足，您可以升级存储空间，详情请参见变更配置方案概览。

二、注意事项

该操作为全量数据迁移。为保障数据一致性，迁移操作开始前请停止自建数据库的相关业务，并停止数据写入。如果您之前使用Mongodump命令对数据库进行过备份操作，请将dump文件夹中的备份文件移动至其他目录并确保dump文件夹为空，否则执行备份操作将会覆盖该文件夹中的历史备份文件。请在数据库服务器上执行Mongodump和Mongorestore命令，并非在mongo shell环境下执行。

三、操作步骤

1. 备份自建数据库

1）在自建MongoDB数据库所属的服务器中执行以下命令，备份所有数据库的数据。

mongodump --host <mongodb_host> --port <port>  -u <username>  --authenticationDatabase  <database>

说明

：自建MongoDB数据库的服务器地址，本机可使用127.0.0.1。：数据库服务的端口号，默认为27017。：自建MongoDB数据库的数据库账号。：鉴权数据库名，即数据库账号所属的数据库。

示例：

mongodump --host 127.0.0.1 --port 27017 -u root --authenticationDatabase admin

2）当命令行提示Enter password:时，输入数据库账号对应的密码并按回车键确认，即开始执行备份操作。**

说明 输入密码时，密码字符是不可见的。

等待备份完成，自建数据库中的数据即备份至当前目录下的dump文件夹中。

2. 将数据迁移至阿里云

1）获取副本集实例Primary节点的公网或内网连接地址，详情请参见副本集实例连接说明。

获取阿里云MongoDB实例Primary节点的连接地址。

登录MongoDB管理控制台。在页面左上角，选择实例所属的地域。在左侧导航栏，单击副本集实例列表。找到目标实例，单击实例ID。在左侧导航栏，单击数据库连接，即可查看数据库连接信息。

表 1. 连接地址说明

地址类型

说明

适用场景

专有网络连接地址    专有网络是一种隔离的网络环境，安全性和性能均高于传统的经典网络。    适用于自建MongoDB数据库部署在ECS实例上的场景。
说明 需要ECS实例和阿里云MongoDB实例属于同一地域，同一VPC网络。    

公网连接地址    为保障安全性，默认未提供公网连接地址，需要您手动申请，详情请参见申请公网连接地址。    适用于自建MongoDB数据库部署在本地设备的场景。    

2）将自建数据库所属服务器的IP地址加入至副本集实例的白名单中，详情请参见设置白名单。

说明

通过内网地址连接副本集实例时，您需要将自建数据库所属ECS的内网IP地址加入至副本集实例的白名单中。通过公网地址连接副本集实例时，将需要将自建数据库所属本地服务器的公网IP地址加入至副本集实例的白名单中。

3）在自建数据库服务器上执行以下语句，将备份的数据全部迁移至副本集实例。

mongorestore --host <Primary_host>  -u <username> --authenticationDatabase <database> <Backup directory>

说明

：副本集实例中Primary节点的连接地址。：副本集实例的数据库账号，初始账号为root。：鉴权数据库名，即数据库账号所属的数据库。当数据库账号为root时，对应的数据库为admin。：备份文件存储的目录，默认为dump。

示例：

mongorestore --host dds-bp**********-pub.mongodb.rds.aliyuncs.com:3717 -u root --authenticationDatabase admin dump

4）当命令行提示Enter password:时，输入副本集实例的数据库账号对应的密码并按回车键确认，即开始执行数据迁移操作。

说明

输入密码时，密码字符是不可见的。如果忘记了root账号的密码，您可以通过设置密码的方式来重置密码。

等待数据迁移完成，根据业务需求选择合适的时间，将业务切换至副本集实例。