本文介绍如何使用数据传输服务DTS（Data Transmission Service），将云数据库MongoDB版（副本集架构）迁移至云数据库MongoDB版（副本集架构或分片集群架构）。
支持的源和目标数据库
| 源数据库（副本集架构） | 目标数据库（副本集架构、分片集群架构） |
|---|---|
| 云数据库MongoDB版 | 云数据库MongoDB版 |
| ECS上的自建数据库 | ECS上的自建数据库 |
| 通过专线、VPN网关或智能网关接入的自建数据库 | 通过专线、VPN网关或智能网关接入的自建数据库 |
| 有公网IP的自建数据库 | 有公网IP的自建数据库 |
本文以云数据库MongoDB版（副本集架构）、云数据库MongoDB版（副本集架构或分片集群架构）为例介绍配置流程，其他数据源的配置流程与本案例相似。
前提条件
- 已创建源云数据库MongoDB版（副本集架构）和目标云数据库MongoDB版（副本集架构或分片集群架构）。创建方式，请参见创建副本集实例和创建分片集群实例。
说明 支持的版本，请参见迁移方案概览。
- 目标云数据库MongoDB版的存储空间须大于源云数据库MongoDB版占用的存储空间。
- 如目标云数据库MongoDB版为分片集群架构，您需要根据业务需要，在目标云数据库MongoDB版中创建需要分片的数据库和集合，并配置数据分片。配置方式，请参见设置数据分片以充分利用Shard性能。
说明 配置数据分片可避免数据被迁移至同一Shard，导致无法发挥集群性能。
注意事项
| 类型 | 说明 |
|---|---|
| 源库限制 |
|
| 其他限制 |
|
| 特殊情况 | 当源库为自建MongoDB时：
说明 如果迁移对象选择为整库，您还可以创建心跳，心跳每秒定期更新或者写入数据。
|
费用说明
| 迁移类型 | 链路配置费用 | 公网流量费用 |
|---|---|---|
| 结构迁移和全量数据迁移 | 不收费。 | 通过公网将数据迁移出阿里云时将收费，详情请参见产品定价。 |
| 增量数据迁移 | 收费，详情请参见产品定价。 |
迁移类型说明
| 迁移类型 | 说明 |
|---|---|
| 库表结构迁移 | 将源云数据库MongoDB版中迁移对象的结构迁移到目标云数据库MongoDB版中。
说明 支持结构迁移的对象为DATABASE、COLLECTION、INDEX。
|
| 全量迁移 | 将源云数据库MongoDB版迁移对象的存量数据全部迁移到目标云数据库MongoDB版中。
说明 支持全量迁移DATABASE、COLLECTION、INDEX中的数据。
|
| 增量迁移 | 在全量迁移的基础上，将源云数据库MongoDB版的增量更新迁移到目标云数据库MongoDB版中。
说明 支持迁移如下增量更新：
|
数据库账号的权限要求
| 数据库 | 库表结构迁移 | 全量迁移 | 增量迁移 |
|---|---|---|---|
| 源云数据库MongoDB版 | 待迁移库的read权限。 | 待迁移库、admin库和local库的read权限。 | |
| 目标云数据库MongoDB版 | dbAdminAnyDatabase权限、目标库的readWrite权限、local库的read权限。 | ||
源和目标云数据库MongoDB版数据库账号创建及授权方法，请参见使用DMS管理MongoDB数据库用户。
操作步骤
- 在页面左上角，选择迁移实例所属地域。
- 单击创建任务，配置源库及目标库信息。警告 选择源和目标实例后，建议您仔细阅读页面上方显示的使用限制，以成功创建并执行迁移任务。
类别 配置 说明 无 任务名称 DTS会自动生成一个任务名称，建议配置具有业务意义的名称（无唯一性要求），便于后续识别。
源库信息 选择已有的数据库连接模版 如该实例的连接信息已保存为模板，您可选择其对应的连接名称，DTS将自动输入已保存的连接信息。说明- 如需修改模板的连接信息，您可以在该实例配置信息进行编辑。
- 如需修改模板名称，您可以在该实例配置信息最下方，单击编辑连接信息模板名称，自定义连接信息模板的名称。
- 修改后的连接信息模板，将在下一次选择该连接模板作为实例连接信息时生效，不会影响原先已使用该模板配置的实例连接信息。
数据库类型 选择MongoDB。 接入方式 选择阿里云实例。 实例地区 选择源云数据库MongoDB版所属地域。 实例ID 选择源云数据库MongoDB版实例ID。 数据库名称 填入admin。 说明 需为鉴权数据库名，即数据库账号所属的数据库。数据库账号 填入源云数据库MongoDB版的数据库账号，权限要求，请参见数据库账号的权限要求。 数据库密码 填入该数据库账号对应的密码。
将连接信息保存为模板 单击将连接信息保存为模板并在弹跳框中设置连接名称，可将该实例的连接信息保存为模板，便于下次自动传入。说明 建议连接名称配置为具有业务意义的名称（无唯一性要求），便于后续识别。目标库信息 选择已有的数据库连接模版 如该实例的连接信息已保存为模板，您可选择其对应的连接名称，DTS将自动输入已保存的连接信息。说明- 如需修改模板的连接信息，您可以在该实例配置信息进行编辑。
- 如需修改模板名称，您可以在该实例配置信息最下方，单击编辑连接信息模板名称，自定义连接信息模板的名称。
- 修改后的连接信息模板，将在下一次选择该连接模板作为实例连接信息时生效，不会影响原先已使用该模板配置的实例连接信息。
数据库类型 选择MongoDB。 接入方式 选择阿里云实例。 实例地区 选择目标云数据库MongoDB版所属地域。 实例ID 选择目标云数据库MongoDB版实例ID。 数据库名称 填入admin。 说明 填入鉴权数据库名，即数据库账号所属的数据库。数据库账号 填入目标云数据库MongoDB版的数据库账号，权限要求，请参见数据库账号的权限要求。 数据库密码 填入该数据库账号对应的密码。
将连接信息保存为模板 单击将连接信息保存为模板并在弹跳框中设置连接名称，可将该实例的连接信息保存为模板，便于下次自动传入。说明 建议连接名称配置为具有业务意义的名称（无唯一性要求），便于后续识别。 - 配置任务对象及高级配置。
- 基础配置
配置 说明 任务步骤 - 如果只需要进行全量迁移，请同时勾选库表结构迁移和全量迁移。
- 如果需要进行不停机迁移，请同时勾选库表结构迁移、全量迁移和增量迁移。
说明 如果未选择增量迁移，为保障数据一致性，数据迁移期间请勿在源实例中写入新的数据。更多任务步骤信息，请参见迁移类型说明。
目标已存在表的处理模式 - 预检查并报错拦截：检查目标数据库中是否有同名的集合。如果目标数据库中没有同名的集合，则通过该检查项目；如果目标数据库中有同名的集合，则在预检查阶段提示错误，数据迁移任务不会被启动。
说明 如果目标库中同名的集合不方便删除或重命名，您可以更改该集合在目标库中的名称，请参见库表列名映射。
- 忽略报错并继续执行：跳过目标数据库中是否有同名集合的检查项。
警告 选择为忽略报错并继续执行，可能导致数据不一致，给业务带来风险，例如：
- 在目标库遇到与源库主键的值相同的记录，则会保留目标库中的该条记录，即源库中的该条记录不会迁移至目标库中。
- 可能会导致无法初始化数据、只能迁移部分的数据或迁移失败。
迁移对象 在迁移对象框中单击待迁移的对象，然后单击
将其移动到已选择对象框。
说明 同步对象的选择粒度为DATABASE、COLLECTION。映射名称更改 过滤待迁移数据 支持设置条件过滤数据，详情请参见通过SQL条件过滤任务数据。
- 高级配置
配置 说明 设置告警 是否设置告警，当迁移失败或延迟超过阈值后，将通知告警联系人。- 不设置：不设置告警。
- 设置：设置告警，您还需要设置告警阈值和告警联系人。
目标库对象名称大小写策略 您可以配置目标实例中迁移对象的库名、集合名的英文大小写策略。默认情况下选择DTS默认策略，您也可以选择与源库、目标库默认策略保持一致。更多信息，请参见目标库对象名称大小写策略
源、目标库无法连接重试时间 默认重试120分钟，您也可以在取值范围（10~1440分钟）内自定义重试时间，建议设置30分钟以上。如果DTS在设置的时间内重新连接上源、目标库，迁移任务将自动恢复。否则，迁移任务将失败。说明- 针对同源或者同目标的多个DTS实例，如DTS实例A和DTS实例B，设置网络重试时间时A设置30分钟，B设置60分钟，则重试时间以低的30分钟为准。
- 由于连接重试期间，DTS将收取任务运行费用，建议您根据业务需要自定义重试时间，或者在源和目标库实例释放后尽快释放DTS实例。
- 基础配置
- 上述配置完成后，单击页面右下角的下一步保存任务并预检查。 说明
- 在迁移任务正式启动之前，会先进行预检查。只有预检查通过后，才能成功启动迁移任务。
- 如果预检查失败，单击具体检查项后的
，查看失败详情。
- 您可以根据提示修复后重新进行预检查。
- 如无需修复告警检测项，您也可以选择确认屏蔽、忽略告警项并重新进行预检查，跳过告警检测项重新进行预检查。
设置方式，请参见