Mongodump和Mongorestore是MongoDB数据库自带的备份恢复工具。您可以在本地设备或ECS实例中安装MongoDB数据库，然后借助该工具将自建MongoDB数据库迁移至阿里云MongoDB实例。
推荐使用DTS迁移单节点架构的自建MongoDB数据库上云，可实现不停机迁移上云，操作步骤，请参见云数据库MongoDB版（单节点架构）全量迁移至云数据库MongoDB版（所有架构）。
更多数据迁移或同步场景的解决方案，请参见数据迁移和同步方案概览。
前提条件
请确保安装的Mongodump和Mongorestore软件版本与自建MongoDB数据库的版本一致。安装步骤请参见官方文档Install MongoDB。
说明您也可以直接在自建MongoDB数据库所属的服务器上执行Mongodump和Mongorestore命令，无需安装。
为保障兼容性，自建MongoDB数据库的版本需为3.0及以上版本。
说明阿里云MongoDB实例支持的存储引擎请参见版本及存储引擎，如需跨版本或跨引擎迁移，请提前确认兼容性。
单节点实例的存储空间应大于自建MongoDB数据库已占用的存储空间。如存储空间不足，您可以升级存储空间，详情请参见变更配置方案概览。
注意事项
该操作为全量数据迁移。为保障数据一致性，迁移操作开始前请停止自建数据库的相关业务，并停止数据写入。
如果您之前使用Mongodump命令对数据库进行过备份操作，请将dump文件夹中的备份文件移动至其他目录并确保dump文件夹为空，否则执行备份操作将会覆盖该文件夹中的历史备份文件。
请在自建MongoDB数据库服务器上执行Mongodump和Mongorestore命令，并非在Mongo Shell环境下执行。
步骤一：备份自建数据库
在自建MongoDB数据库所属的服务器中执行以下命令，备份所有数据库的数据。
mongodump --host <mongodb_host> --port <port> -u <username> --authenticationDatabase <database>说明<mongodb_host>：自建MongoDB数据库的服务器地址，本机可使用127.0.0.1。
<port>：数据库服务的端口号，默认为27017。
<username>：自建MongoDB数据库的数据库账号，本文以test为示例账号。
<database>：鉴权数据库名，即数据库账号所属的数据库。
示例：
mongodump --host 127.0.0.1 --port 27017 -u test --authenticationDatabase admin当命令行提示
Enter password:时，输入数据库账号对应的密码并按回车键确认，即开始执行备份操作。说明输入密码时，密码字符是不可见的。
等待备份完成，自建数据库中的数据即备份至当前目录下的dump文件夹中。
步骤二：将数据迁移至阿里云
获取阿里云MongoDB实例Primary节点的连接地址。
登录MongoDB管理控制台。
在页面左上角，选择实例所属的地域。
在左侧导航栏，单击副本集实例列表。
找到目标实例，单击实例ID。
在左侧导航栏，单击数据库连接，即可查看数据库连接信息。
将自建数据库所属服务器的IP地址加入至MongoDB实例的白名单中，详情请参见设置白名单。
说明通过专有网络连接阿里云MongoDB实例时，您需要将自建数据库所属ECS的内网IP地址加入至阿里云MongoDB实例的白名单中。
通过公网地址连接阿里云MongoDB实例时，将需要将自建数据库所属本地服务器的公网IP地址加入至阿里云MongoDB实例的白名单中。
在自建数据库服务器上执行以下语句，将备份的数据全部迁移至阿里云MongoDB实例。
mongorestore --host <Primary_host> -u <username> --authenticationDatabase <database> <Backup directory>说明<Primary_host>：阿里云MongoDB实例中Primary节点的连接地址。
<username>：阿里云MongoDB实例的数据库账号，初始账号为root。
<database>：鉴权数据库名，即数据库账号所属的数据库。当数据库账号为root时，对应的数据库为admin。
<Backup directory>：备份文件存储的目录，默认为dump。
示例：
数据库账号为test，所属数据库为admin。
mongorestore --host dds-bp19f409d7512****-pub.mongodb.rds.aliyuncs.com:3717 -u test --authenticationDatabase admin dump当命令行提示
Enter password:时，输入阿里云MongoDB实例数据库账号对应的密码并按回车键确认，即开始执行数据迁移操作。说明输入密码时，密码字符是不可见的。
如果忘记了root账号的密码，您可以通过设置密码的方式来重置密码。
等待数据迁移完成，根据业务需求选择合适的时间，将业务切换至阿里云MongoDB实例。
更多信息
数据库迁移至阿里云MongoDB实例后，您可以执行连接数据库、管理数据库和数据库账号等操作。