本文介绍如何使用数据传输服务DTS（Data Transmission Service），将MongoDB Atlas数据库增量迁移至阿里云。DTS支持全量数据迁移和增量数据迁移，同时选择这两种迁移类型可以实现在不停服的情况下，平滑地完成MongoDB Atlas数据库的迁移。
前提条件
阿里云MongoDB实例的存储空间须大于MongoDB Atlas数据库占用的存储空间。注意事项
- DTS在执行全量数据迁移时将占用源库和目标库一定的资源，可能会导致数据库服务器负载上升。如果数据库业务量较大或服务器规格较低，可能会加重数据库压力，甚至导致数据库服务不可用。建议您在执行数据迁移前谨慎评估，在业务低峰期执行数据迁移。
- 不支持迁移admin和local数据库。
- config数据库属于系统内部数据库，如无特殊需求，请勿迁移该库。
- 阿里云MongoDB实例支持的版本与存储引擎请参见版本及存储引擎，如需跨版本或跨引擎迁移，请提前确认兼容性。
费用说明
| 迁移类型 | 链路配置费用 | 公网流量费用 |
|---|---|---|
| 全量数据迁移 | 不收费。 | 通过公网将数据迁移出阿里云时将收费，详情请参见计费概述。 |
| 增量数据迁移 | 收费，详情请参见计费概述。 |
迁移类型说明
| 迁移类型 | 说明 |
|---|---|
| 全量数据迁移 | 将源MongoDB数据库迁移对象的存量数据全部迁移到目标MongoDB数据库中。 说明 支持迁移database、collection和index。 |
| 增量数据迁移 | 在全量迁移的基础上，将源MongoDB数据库的增量更新数据同步到目标MongoDB数据库中。 说明
|
数据库账号的权限要求
| 数据库 | 全量数据迁移 | 增量数据迁移 |
|---|---|---|
| MongoDB Atlas数据库 | 待迁移库的read权限、listDatabases权限。 |
|
| 阿里云MongoDB实例 | 目标库的readWrite权限。 | 目标库的readWrite权限。 |
数据库账号创建及授权方法：
- MongoDB Atlas数据库请参见MongoDB Create User说明。
- 阿里云MongoDB实例请参见使用DMS管理MongoDB数据库用户。
准备工作
- 登录MongoDB Atlas数据库控制台。
- 在左侧栏单击Network Access，然后单击ADD IP ADDRESS。
- 在弹出对话框中，单击ALLOW ACCESS FROM ANYWHERE，然后单击Confirm。
说明 执行此步骤将允许所有IP地址访问您的MongoDB Atlas数据库，迁移完成后请删除该规则。
操作步骤
- 购买数据迁移实例，详情请参见购买数据迁移任务。
- 登录数据传输控制台。
- 在左侧导航栏，单击数据迁移。
- 在迁移任务列表页面顶部，选择阿里云MongoDB实例所属地域。
- 定位至已购买的数据迁移实例，单击配置迁移任务。
- 配置迁移任务的源库及目标库信息。
类别 配置 说明 无 任务名称 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实例的数据库账号，权限要求请参见数据库账号的权限要求。 数据库密码 填入该数据库账号的密码。 说明 目标库信息填写完毕后，您可以单击数据库密码后的测试连接来验证填入的目标库信息是否正确。目标库信息填写正确则提示测试通过，如提示测试失败，单击测试失败后的诊断，根据提示调整填写的目标库信息。 - 完成上述配置后，单击页面右下角的授权白名单并进入下一步。警告 DTS自动添加或您手动添加DTS服务的公网IP地址段可能会存在安全风险，一旦使用本产品代表您已理解和确认其中可能存在的安全风险，并且需要您做好基本的安全防护，包括但不限于加强账号密码强度防范、限制各网段开放的端口号、内部各API使用鉴权方式通信、定期检查并限制不需要的网段，或者使用通过内网（专线/VPN网关/智能网关）的方式接入。
- 选择迁移类型和迁移对象。
配置 说明 迁移类型 - 如果只需要进行全量迁移，在迁移类型选择时勾选全量数据迁移。
- 如果需要进行不停机迁移，在迁移类型选择时勾选全量数据迁移和增量数据迁移。
说明 如果未勾选增量数据迁移，为保障数据一致性，数据迁移期间请勿在源库中写入新的数据。迁移对象 - 在迁移对象框中单击待迁移的对象，然后单击
将其移动到已选择对象框。 说明 不支持迁移admin、local、config数据库。 - 迁移对象选择的粒度为：database、collection或function。
- 默认情况下，迁移对象的名称不变。如果您改变迁移对象在阿里云MongoDB数据库中的名称，需要使用DTS提供的对象名映射功能。使用方法请参见库表列映射。
映射名称更改 如需更改迁移对象在目标实例中的名称，请使用对象名映射功能，详情请参见库表列映射。 源、目标库无法连接重试时间 默认重试12小时，您也可以自定义重试时间。如果DTS在设置的时间内重新连接上源、目标库，迁移任务将自动恢复。否则，迁移任务将失败。 说明 由于连接重试期间，DTS将收取任务运行费用，建议您根据业务需要自定义重试时间，或者在源和目标库实例释放后尽快释放DTS实例。 - 上述配置完成后，单击页面下方的下一步保存任务并预检查。 说明
- 在迁移任务正式启动之前，会先进行预检查。只有预检查通过后，才能成功启动迁移任务。
- 如果预检查失败，请单击失败检查项后的查看详情，并根据提示修复后重新进行预检查。
- 如果预检查产生警告：
- 对于不可以忽略的检查项，请单击失败检查项后的查看详情，并根据提示修复后重新进行预检查。
- 对于可以忽略无需修复的检查项，您可以依次单击点击确认告警详情、确认屏蔽、确定、重新进行预检查，跳过告警检查项重新进行预检查。如果选择屏蔽告警检查项，可能会导致数据不一致等问题，给业务带来风险。
- 预检查通过后，单击下一步。
- 在购买配置确认页面，选择链路规格并勾选数据传输（按量付费）服务条款。
- 单击购买并启动，迁移任务正式开始。
- 全量数据迁移
请勿手动结束迁移任务，否则可能会导致数据不完整。您只需等待迁移任务完成即可，迁移任务会自动结束。
- 增量数据迁移
迁移任务不会自动结束，需要手动结束迁移任务。
说明 请选择合适的时间手动结束迁移任务，例如业务低峰期或准备将业务切换至阿里云MongoDB实例时。- 观察迁移任务的进度变更为增量迁移，并显示为无延迟状态时，将源库停写几分钟，此时增量迁移的状态可能会显示延迟的时间。
- 等待迁移任务的增量迁移再次进入无延迟状态，手动结束迁移任务。
- 全量数据迁移
- 将业务切换至阿里云MongoDB实例。