本文介绍如何使用数据传输服务DTS（Data Transmission Service），将MongoDB Atlas数据库增量迁移至阿里云。DTS支持全量数据迁移和增量数据迁移，同时选择这两种迁移类型可以实现在不停服的情况下，平滑地完成MongoDB Atlas数据库的迁移。

前提条件

阿里云MongoDB实例的存储空间须大于MongoDB Atlas数据库占用的存储空间。

注意事项

  • DTS在执行全量数据迁移时将占用源库和目标库一定的资源，可能会导致数据库服务器负载上升。如果数据库业务量较大或服务器规格较低，可能会加重数据库压力，甚至导致数据库服务不可用。建议您在执行数据迁移前谨慎评估，在业务低峰期执行数据迁移。
  • 不支持迁移admin和local数据库。
  • config数据库属于系统内部数据库，如无特殊需求，请勿迁移该库。
  • 阿里云MongoDB实例支持的版本与存储引擎请参见版本及存储引擎，如需跨版本或跨引擎迁移，请提前确认兼容性。

费用说明

迁移类型 链路配置费用 公网流量费用
全量数据迁移 不收费。 通过公网将数据迁移出阿里云时将收费，详情请参见产品定价。
增量数据迁移 收费，详情请参见产品定价。

迁移类型说明

迁移类型 说明
全量数据迁移 将源MongoDB数据库迁移对象的存量数据全部迁移到目标MongoDB数据库中。
说明 支持迁移database、collection和index。
增量数据迁移 在全量迁移的基础上，将源MongoDB数据库的增量更新数据同步到目标MongoDB数据库中。
说明
  • 支持database、collection和index的新建和删除操作的同步。
  • 支持document的新增、删除和更新操作的同步。

数据库账号的权限要求

数据库 全量数据迁移 增量数据迁移
MongoDB Atlas数据库 待迁移库的read权限、listDatabases权限。
  • 待迁移库、admin库和local库的read权限。
  • listDatabases权限。
阿里云MongoDB实例 目标库的readWrite权限。 目标库的readWrite权限。

数据库账号创建及授权方法：

准备工作

  1. 登录MongoDB Atlas数据库控制台。
  2. 在左侧栏单击Network Access，然后单击ADD IP ADDRESS。
    添加Atlas白名单
  3. 在弹出对话框中，单击ALLOW ACCESS FROM ANYWHERE，然后单击Confirm。
    设置Atlas白名单
    说明 执行此步骤将允许所有IP地址访问您的MongoDB Atlas数据库，迁移完成后请删除该规则。

操作步骤

  1. 登录数据传输控制台。
  2. 在左侧导航栏，单击数据迁移。
  3. 在迁移任务列表页面顶部，选择阿里云MongoDB实例所属地域。
    选择地域
  4. 单击页面右上角的创建迁移任务。
  5. 配置迁移任务的源库及目标库信息。
    设置源和目标库信息
    类别 配置 说明
    无 任务名称 DTS会自动生成一个任务名称，建议配置具有业务意义的名称（无唯一性要求），便于后续识别。
    源库信息 实例类型 选择有公网IP的自建数据库。
    实例地区 当实例类型选择为有公网IP的自建数据库时，实例地区无需设置。
    数据库类型 选择MongoDB。
    主机名或IP地址

    填入MongoDB Atlas数据库中，PRIMARY节点的访问地址。

    您可以在MongoDB Atlas控制台中获取，详细步骤请参见下图。

    获取Atlas地址
    端口 填入MongoDB Atlas数据库的服务端口，默认为27017。
    数据库名称 填入鉴权数据库名，即数据库账号所属的数据库。
    数据库账号 填入MongoDB Atlas的数据库账号，权限要求请参见数据库账号的权限要求。
    数据库密码 填入该数据库账号的密码。
    说明 源库信息填写完毕后，您可以单击数据库密码后的测试连接来验证填入的源库信息是否正确。源库信息填写正确则提示测试通过，如提示测试失败，单击测试失败后的诊断，根据提示调整填写的源库信息。
    连接方式 选择SSL安全连接。
    目标库信息 实例类型 选择MongoDB实例。
    实例地区 选择阿里云MongoDB实例所属地域。
    MongoDB实例ID 选择阿里云MongoDB实例ID。
    数据库名称 填入鉴权数据库名，即数据库账号所属的数据库。
    说明 如果使用的数据库账号为root，那么对应的数据库名称即为admin。
    数据库账号 填入阿里云MongoDB实例的数据库账号，权限要求请参见数据库账号的权限要求。
    数据库密码 填入该数据库账号的密码。
    说明 目标库信息填写完毕后，您可以单击数据库密码后的测试连接来验证填入的目标库信息是否正确。目标库信息填写正确则提示测试通过，如提示测试失败，单击测试失败后的诊断，根据提示调整填写的目标库信息。
  6. 完成上述配置后，单击页面右下角的授权白名单并进入下一步。
    说明 此步骤会将DTS服务器的IP地址自动添加阿里云MongoDB实例的白名单中，用于保障DTS服务器能够正常连接阿里云MongoDB实例。
  7. 选择迁移类型和迁移对象。
    配置 说明
    迁移类型
    • 如果只需要进行全量迁移，在迁移类型选择时勾选全量数据迁移。
    • 如果需要进行不停机迁移，在迁移类型选择时勾选全量数据迁移和增量数据迁移。
    说明 如果未勾选增量数据迁移，为保障数据一致性，数据迁移期间请勿在源库中写入新的数据。
    迁移对象
    • 在迁移对象框中单击待迁移的对象，然后单击向右箭头将其移动到已选择对象框。
      说明 不支持迁移admin和local数据库。
    • 迁移对象选择的粒度为：database、collection或function。
    • 默认情况下，迁移对象的名称不变。如果您改变迁移对象在阿里云MongoDB数据库中的名称，需要使用DTS提供的对象名映射功能。使用方法请参见库表列映射。
  8. 上述配置完成后，单击页面右下角的预检查并启动。
    说明
    • 在迁移任务正式启动之前，会先进行预检查。只有预检查通过后，才能成功启动迁移任务。
    • 如果预检查失败，单击具体检查项后的提示，查看失败详情。根据提示修复问题后，重新进行预检查。
  9. 预检查通过后，单击下一步。
  10. 在购买配置确认页面，选择链路规格并勾选数据传输（按量付费）服务条款。
  11. 单击购买并启动，迁移任务正式开始。
    • 全量数据迁移

      请勿手动结束迁移任务，否则可能会导致数据不完整。您只需等待迁移任务完成即可，迁移任务会自动结束。

    • 增量数据迁移

      迁移任务不会自动结束，需要手动结束迁移任务。

      说明 请选择合适的时间手动结束迁移任务，例如业务低峰期或准备将业务切换至阿里云MongoDB实例时。
      1. 观察迁移任务的进度变更为增量迁移，并显示为无延迟状态时，将源库停写几分钟，此时增量迁移的状态可能会显示延迟的时间。
      2. 等待迁移任务的增量迁移再次进入无延迟状态，手动结束迁移任务。增量迁移无延迟
  12. 将业务切换至阿里云MongoDB实例。