注意事项

• 为避免影响您的正常业务使用，请在业务低峰期进行数据迁移。
• 不支持迁移admin和local数据库。
• config数据库属于系统内部数据库，如无特殊需求，请勿迁移该库。
• 阿里云MongoDB实例支持的版本与存储引擎请参见版本及存储引擎，如需跨版本或跨引擎迁移，请提前确认兼容性。

费用说明

数据库账号的权限要求

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

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

准备工作

1. 登录MongoDB Atlas数据库控制台。
2. 在左侧栏单击Network Access，然后单击ADD IP ADDRESS。
   
3. 在弹出对话框中，单击ALLOW ACCESS FROM ANYWHERE，然后单击Confirm。
   

   说明 执行此步骤将允许所有IP地址访问您的MongoDB Atlas数据库，迁移完成后请删除该规则。

操作步骤

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

   类别	配置	说明
   任务名称	-	DTS会自动生成一个任务名称，建议配置具有业务意义的名称（无唯一性要求），便于后续识别。
   源库信息	实例类型	选择有公网IP的自建数据库。
   	实例地区	当实例类型选择为有公网IP的自建数据库时，实例地区无需设置。
   	数据库类型	选择MongoDB。
   	主机名或IP地址	填入MongoDB Atlas数据库中，PRIMARY节点的访问地址。 您可以在MongoDB Atlas控制台中获取，详细步骤请参见下图。
   	端口	填入MongoDB Atlas数据库的服务端口，默认为27017。
   	数据库名称	填入鉴权数据库名，即数据库账号所属的数据库。
   	数据库账号	填入MongoDB Atlas的数据库账号，权限要求请参见数据库账号的权限要求。
   	数据库密码	填入该数据库账号对应的密码。 说明 源库信息填写完毕后，您可以单击数据库密码后的测试连接来验证填入的源库信息是否正确。源库信息填写正确则提示测试通过，如提示测试失败，单击测试失败后的诊断，根据提示调整填写的源库信息。
   	连接方式	选择SSL安全连接。
   目标库信息	实例类型	选择MongoDB实例。
   	实例地区	选择阿里云MongoDB实例所属地域。
   	MongoDB实例ID	选择阿里云MongoDB实例ID。
   	数据库名称	填入鉴权数据库名，即数据库账号所属的数据库。 说明 如果使用的数据库账号为root，那么对应的数据库名称即为admin。
   	数据库账号	填入阿里云MongoDB实例的数据库账号，权限要求请参见数据库账号的权限要求。
   	数据库密码	填入该数据库账号对应的密码。 说明 目标库信息填写完毕后，您可以单击数据库密码后的测试连接来验证填入的目标库信息是否正确。目标库信息填写正确则提示测试通过，如提示测试失败，单击测试失败后的诊断，根据提示调整填写的目标库信息。

6. 完成上述配置后，单击页面右下角的授权白名单并进入下一步。
   

   说明 此步骤会将DTS服务器的IP地址自动添加阿里云MongoDB实例的白名单中，用于保障DTS服务器能够正常连接阿里云MongoDB实例。
7. 选择迁移类型和迁移对象。

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

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

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

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

    • 增量数据迁移

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

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