全部产品
Search
文档中心

云数据库 MongoDB:使用MongoDB工具将自建数据库迁移至单节点实例

更新时间:Jan 11, 2024

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环境下执行。

步骤一:备份自建数据库

  1. 在自建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
  2. 当命令行提示Enter password:时,输入数据库账号对应的密码并按回车键确认,即开始执行备份操作。

    说明

    输入密码时,密码字符是不可见的。

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

步骤二:将数据迁移至阿里云

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

    1. 登录MongoDB管理控制台

    2. 在页面左上角,选择实例所属的地域。

    3. 在左侧导航栏,单击副本集实例列表

    4. 找到目标实例,单击实例ID。

    5. 在左侧导航栏,单击数据库连接,即可查看数据库连接信息。

      MongoDB单节点查看连接信息

      表 1. 连接地址说明

      地址类型

      说明

      适用场景

      专有网络连接地址

      专有网络是一种隔离的网络环境,安全性和性能均高于传统的经典网络。

      适用于自建MongoDB数据库部署在ECS实例上的场景。

      说明

      需要ECS实例和阿里云MongoDB实例属于同一地域,同一VPC网络。

      公网连接地址

      为保障安全性,默认未提供公网连接地址,需要您手动申请,详情请参见申请公网连接地址

      适用于自建MongoDB数据库部署在本地设备的场景。

  2. 将自建数据库所属服务器的IP地址加入至MongoDB实例的白名单中,详情请参见设置白名单

    说明
    • 通过专有网络连接阿里云MongoDB实例时,您需要将自建数据库所属ECS的内网IP地址加入至阿里云MongoDB实例的白名单中。

    • 通过公网地址连接阿里云MongoDB实例时,将需要将自建数据库所属本地服务器的公网IP地址加入至阿里云MongoDB实例的白名单中。

  3. 在自建数据库服务器上执行以下语句,将备份的数据全部迁移至阿里云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
  4. 当命令行提示Enter password:时,输入阿里云MongoDB实例数据库账号对应的密码并按回车键确认,即开始执行数据迁移操作。

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

    • 如果忘记了root账号的密码,您可以通过设置密码的方式来重置密码。

等待数据迁移完成,根据业务需求选择合适的时间,将业务切换至阿里云MongoDB实例。

更多信息

数据库迁移至阿里云MongoDB实例后,您可以执行连接数据库、管理数据库和数据库账号等操作。