前提条件

• 华为云文档数据库为单节点实例或副本集实例。
  说明 使用DTS迁移单节点实例至阿里云时，不支持增量数据迁移。
• 阿里云MongoDB实例的存储空间应大于华为云文档数据库的存储空间。

注意事项

• 为避免影响您的业务使用，请在业务低峰期进行数据迁移操作。
• 对于迁移失败的任务，DTS会触发自动恢复。当您需要将业务切换至目标实例时，请务必先结束或释放该任务，避免该任务被自动恢复后，导致源端数据覆盖目标实例的数据。
• 不支持迁移admin和local数据库。
• 阿里云MongoDB实例支持的版本与存储引擎请参见版本及存储引擎，如需跨版本或跨引擎迁移，请提前确认兼容性。

费用说明

迁移类型说明

数据库账号的权限要求

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

• 阿里云MongoDB实例请参见使用DMS管理MongoDB数据库用户。
• 华为云文档数据库请参见MongoDB Create User说明。

迁移前准备工作

1. 登录华为云文档数据库控制台。
2. 单击实例ID，进入实例管理页面。
3. 在基本信息页签的实例信息区域框中，单击SSL的滑块关闭SSL功能。
   说明 关闭SSL功能将会导致实例重启，请谨慎操作。
4. 在基本信息页签的节点信息模块，单击绑定弹性IP。
   说明 您可以为Secondary或Primary角色的节点绑定公网IP地址。

   • Primary节点：副本集实例中的主节点，该节点的数据库支持读写。
   • Secondary节点：副本集实例中的从节点，该节点的数据库仅支持只读。
   
5. 在基本信息页签的网络区域框中，单击安全组ID。
6. 在安全组设置页面中，将DTS服务器的IP地址段添加至入方向规则中。
   说明

   • 华为云文档数据库默认的端口为8635，如您修改过，请填入修改后的数据库端口号。
   • 在DTS服务器的IP地址段文档中，根据目标实例的地域信息，选择需要添加的IP地址段。例如，源实例的地域为杭州，目标实例的地域为深圳，那么需要将深圳地区的DTS IP地址段加入至源实例的白名单中。

操作步骤

1. 登录数据传输控制台。
2. 在左侧导航栏，单击数据迁移。
3. 在迁移任务列表页面顶部，选择目标MongoDB实例所属地域。
4. 单击右上角的创建迁移任务。
5. 配置迁移任务的源库及目标库信息。

   类别	配置	说明
   任务名称	-	DTS为每个任务自动生成一个任务名称，任务名称没有唯一性要求。 您可以修改任务名称，建议为任务配置具有业务意义的名称，便于后续的任务识别。
   源库信息	实例类型	选择有公网IP的自建数据库。
   	实例地区	当实例类型选择为有公网IP的自建数据库时，实例地区无需设置。
   	数据库类型	选择MongoDB。
   	主机名或IP地址	填入在迁移前准备工作中，为华为云文档数据库绑定的弹性公网IP地址。
   	端口	填入华为云文档数据库的端口号，本案例中填入8635。
   	数据库名称	填入鉴权数据库名，默认为admin。
   	数据库账号	填入连接华为云文档数据库的数据库账号，权限要求请参见数据库账号的权限要求。
   	数据库密码	填入连接华为云文档数据库的账号对应的密码。 说明 源库信息填写完毕后，您可以单击数据库密码后的测试连接来验证填入的源库信息是否正确。源库信息填写正确则提示测试通过，如提示测试失败，单击测试失败后的诊断，根据提示调整填写的源库信息。
   目标库信息	实例类型	选择MongoDB实例。
   	实例地区	选择阿里云MongoDB实例所在地域。
   	MongoDB实例ID	选择阿里云MongoDB实例ID。
   	数据库名称	填入鉴权数据库名，默认为admin。
   	数据库账号	填入连接阿里云MongoDB实例的数据库账号，权限要求请参见数据库账号的权限要求。
   	数据库密码	填入连接阿里云MongoDB实例的数据库账号对应的密码。 说明 目标库信息填写完毕后，您可以单击数据库密码后的测试连接来验证填入的目标库信息是否正确。目标库信息填写正确则提示测试通过，如提示测试失败，单击测试失败后的诊断，根据提示调整填写的目标库信息。

6. 配置完成后，单击页面右下角的授权白名单并进入下一步。
   说明 此步骤会将DTS服务器的IP地址自动添加到阿里云MongoDB实例的白名单中，用于保障DTS服务器能够正常连接阿里云MongoDB实例。迁移完成后如不再需要可手动删除，详情请参见白名单设置。
7. 选择迁移对象及迁移类型。

   配置	说明
   迁移类型	如果只需要进行全量迁移，则勾选全量数据迁移。 说明 迁移单节点的华为云文档数据库时，仅支持全量数据迁移。为保障数据一致性，全量数据迁移期间请勿在源库中写入新的数据。 如果需要进行不停机迁移，则同时勾选全量数据迁移和增量数据迁移。
   迁移对象	在迁移对象框中单击待迁移对象，然后单击移动到已选择对象框。 说明 不支持迁移admin和local数据库。 迁移对象选择的粒度为database、collection/function。 默认情况下，迁移完成后，迁移对象的名称保持不变。如果您需要迁移对象在目标数据库中的名称不同，那么需要使用DTS提供的对象名映射功能。使用方法请参见库表列映射。

8. 上述配置完成后，单击页面右下角的预检查并启动。
   说明

   • 在迁移任务正式启动之前，会先进行预检查。只有预检查通过后，才能成功启动迁移任务。
   • 如果预检查失败，单击具体检查项后的，查看失败详情。根据提示修复后，重新进行预检查。
9. 预检查通过后，单击下一步。
10. 在购买配置确认页面，选择链路规格并勾选数据传输（按量付费）服务条款。
11. 单击购买并启动，迁移任务正式开始。
    • 全量数据迁移

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

    • 增量数据迁移

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

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

更多信息

当目标实例为分片集群实例时，您可以根据业务需要设置数据分片，详情请参见设置数据分片以充分利用Shard性能。