将MongoDB（分片集群架构）迁移至MongoDB（副本集架构或分片集群架构）-数据传输服务(DTS)-阿里云帮助中心

适用范围

已创建源云数据库MongoDB版（分片集群架构）和目标云数据库MongoDB版（副本集架构或分片集群架构）。创建方式，请参见创建副本集实例和创建分片集群实例。

说明
支持的版本，请参见迁移方案概览。
源云数据库MongoDB版分片集群实例的所有Shard节点需要申请连接地址，且各Shard的账号和密码需保持一致。申请方法，请参见申请Shard连接地址。
迁移前需要关闭源云数据库MongoDB版分片集群实例的Balancer，否则可能导致迁移任务预检查失败。关闭方法，请参见设置数据分片以充分利用Shard性能。
建议目标云数据库MongoDB版的存储空间比源云数据库MongoDB版占用的存储空间大10%。
如目标云数据库MongoDB版为分片集群架构，您需要根据业务需要，在目标云数据库MongoDB版中创建需要分片的数据库和集合、配置数据分片、开启Balancer并进行预分片。更多信息，请参见设置数据分片以充分利用Shard性能和如何处理分片集群架构的MongoDB数据分布不均衡。

说明
配置数据分片可避免数据被迁移至同一Shard，导致无法发挥集群性能；开启Balancer并进行预分片可以避免数据倾斜问题。

注意事项

类型	说明
源库限制	带宽要求：源库所属的服务器需具备足够出口带宽，否则将影响数据迁移速率。待迁移的集合需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。不支持数据中列名（field name）含有`.`符号的情况，可能会导致数据不一致。如迁移对象为集合级别，且需进行编辑（如集合的名称映射），则单次迁移任务仅支持迁移至多1000张集合。当超出数量限制，任务提交后会显示请求报错，此时建议您拆分待迁移的集合，分批配置多个任务，或者配置整库的迁移任务。源库待迁移的单条数据不能超过16 MB，否则会导致任务失败。源库为Azure Cosmos DB for MongoDB或弹性集群的Amazon DocumentDB时，仅支持全量迁移。如需进行增量迁移：源库需开启Oplog日志，并确保Oplog日志至少保留7天以上；或者开启变更流（Change Streams），并确保DTS能够通过Change Streams订阅到源库最近7天内的数据变更。否则可能会因无法获取源库的数据变更而导致任务失败，极端情况下甚至可能会导致数据不一致或丢失。由此导致的问题，不在DTS的SLA保障范围内。重要建议通过Oplog日志获取源库的数据变更。仅4.0及以上版本的MongoDB支持通过Change Streams获取数据变更。源库为Amazon DocumentDB（非弹性集群）时，需要手动开启Change Streams，并在配置任务时将迁移方式选择为ChangeStream，将架构类型选择为分片集群架构。源库的操作限制：在结构迁移和全量迁移阶段，请勿执行库或集合的结构变更（包含数组类型数据的更新），否则会导致数据迁移任务失败或源库与目标库的数据不一致。如仅执行全量数据迁移，请勿向源实例中写入新的数据，否则会导致源库与目标库的数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。若待迁移的集合中包含TTL（Time To Live）索引，则可能会导致数据不一致或实例产生延迟。
其他限制	目标端实例为分片集群架构时：需清除孤立文档，否则将影响迁移性能。若在迁移过程遇到`_id`冲突的文档，则可能导致数据不一致或任务失败。在任务开始前，需要为源端待迁移的数据添加与目标端对应的分片键。若您无法为源端添加分片键，源MongoDB数据库的迁移操作，请参见MongoDB（无分片键）迁移至MongoDB（分片集群架构）。在任务开始后，待迁移的数据在使用INSERT命令时必须包含分片键，使用UPDATE命令时不支持更改分片键。目标端实例为副本集架构时：当接入方式为专线/VPN网关/智能网关、公网IP或云企业网CEN时，域名或IP地址和端口须填入主节点的地址和端口，或配置高可用连接地址。更多关于高可用连接地址的信息，请参见创建源库或目标库为高可用MongoDB的实例。当接入方式为ECS自建数据库时，端口须填入主节点的端口。不支持通过SRV地址连接MongoDB数据库。建议源和目标库的MongoDB的数据库版本保持一致，或者从低版本迁移到高版本以保障兼容性。如为高版本迁移至低版本，可能存在数据库兼容性问题。不支持迁移admin、config和local库中的数据。若目标集合存在唯一索引或目标集合的`capped`属性为`true`时，则在增量迁移阶段该集合不支持并发回放（只支持单线程写入），从而可能会导致任务延迟增高。不保留事务信息，即源库中的事务迁移到目标库时会转变为单条的记录。在DTS将数据写入目标集合时，如果发生主键或唯一键冲突，DTS将直接跳过相应的数据写入语句，保留目标集合已有的数据。若源端为3.6以下版本的MongoDB，且目标端为3.6或3.6以上版本的MongoDB，由于数据库引擎执行计划的差异，可能会导致迁移前后数据中字段的先后顺序不一致（字段和值对应关系一致）。若业务涉及嵌套结构的文本匹配查询逻辑，请评估其（字段的先后顺序不一致）对业务可能产生的影响。执行数据迁移前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据迁移时DTS占用源和目标库一定读写资源，可能会导致数据库的负载上升。由于全量数据迁移会并发执行INSERT操作，导致目标数据库的集合产生碎片，因此全量迁移完成后目标数据库的集合存储空间会比源实例的集合存储空间大。请确认DTS对数据类型为FLOAT或DOUBLE的列的迁移精度是否符合业务预期。DTS会通过`ROUND(COLUMN,PRECISION)`来读取这两类列的值。如果没有明确定义其精度，DTS对FLOAT的迁移精度为38位，对DOUBLE的迁移精度为308位。 DTS会尝试恢复七天之内迁移失败任务。因此业务切换至目标实例前，请务必结束或释放该任务，或者将DTS访问目标实例账号的写权限用`revoke`命令回收掉。避免该任务被自动恢复后，源端数据覆盖目标实例的数据。由于DTS写入数据的逻辑为并发写入，所以会导致目标端占用的存储空间比源端大5%~10%。目标端MongoDB的count数量需要使用`db.$table_name.aggregate([{ $count:"myCount"}])`语法查询。请确保目标端MongoDB没有与源端相同的主键（默认为_id），否则会导致数据丢失。若目标端有与源端相同的主键，请在不影响业务的前提条件下清空目标端的相关数据（删掉目标端中与源端相同_id的文档）。若实例运行失败，DTS技术支持人员将在8小时内尝试恢复该实例。在恢复失败实例的过程中，可能会对该实例进行重启、调整参数等操作。说明在调整参数时，仅会修改DTS实例的参数，不会对数据库中的参数进行修改。可能修改的参数，包括但不限于修改实例参数中的参数。若目标库为分片集群架构的MongoDB，在将业务切换为该数据库后，您需自行确保业务行为符合该MongoDB数据库对分片集合的要求。当源数据库为MongoDB 5.0或更高版本，而目标数据库版本低于5.0时，不支持迁移`capped collection`。迁移时，会导致任务失败或源库与目标库之间的数据不一致。这是由于自MongoDB 5.0版本起，`capped collection`的行为发生了变化，允许显式删除和更新时增大文档体积等操作，而低版本数据库内核无法兼容这些新特性。当前不支持迁移MongoDB 5.0及以上版本引入的时序集合。不支持同步含有非UTF-8编码的数据，可能会导致数据不一致。
特殊情况	当源库为自建MongoDB时：在迁移时，如果源库进行主备切换，将会导致迁移任务失败。由于DTS的延迟时间是根据迁移到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行更新操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个更新操作来更新延迟信息。说明如果迁移对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。

费用说明

迁移类型	链路配置费用	公网流量费用
结构迁移和全量数据迁移	不收费。	当目标库的接入方式为公网IP时收取公网流量费用，详情请参见计费概述。
增量数据迁移	收费，详情请参见计费概述。	当目标库的接入方式为公网IP时收取公网流量费用，详情请参见计费概述。

迁移类型说明

迁移类型	说明
库表结构迁移	将源云数据库MongoDB版中迁移对象的结构迁移到目标云数据库MongoDB版中。说明支持结构迁移的对象为DATABASE、COLLECTION、INDEX。
全量迁移	将源云数据库MongoDB版迁移对象的存量数据全部迁移到目标云数据库MongoDB版中。说明支持全量迁移DATABASE和COLLECTION中的数据。
增量迁移	在全量迁移的基础上，将源云数据库MongoDB版的增量更新迁移到目标云数据库MongoDB版中。使用Oplog 增量迁移不支持在任务开始运行后新建的数据库，支持迁移的增量更新如下： CREATE COLLECTION、INDEX DROP DATABASE、COLLECTION、INDEX 说明不支持携带`dropTarget`选项且值为`true`的RENAME COLLECTION操作。 RENAME COLLECTION 在集合中插入、更新、删除文档的操作。说明在迁移增量更新文档的数据时，仅支持迁移使用`$set`命令更新的操作。使用ChangeStream 支持迁移的增量更新如下： DROP DATABASE、COLLECTION RENAME COLLECTION 说明不支持携带`dropTarget`选项且值为`true`的RENAME COLLECTION操作。在集合中插入、更新、删除文档的操作。说明在迁移增量更新文档的数据时，仅支持迁移使用`$set`命令更新的操作。

数据库账号的权限要求

数据库	库表结构迁移	全量迁移	增量迁移
源云数据库MongoDB版	待迁移库和config库的read权限。		待迁移库、admin库和local库的read权限。
目标云数据库MongoDB版	dbAdminAnyDatabase权限、目标库的readWrite权限、local库的read权限。

源和目标云数据库MongoDB版数据库账号创建及授权方法，请参见使用DMS管理MongoDB数据库用户。

说明

如使用ChangeStream方式进行增量迁移，源库账号需具备整实例的Change Streams读取权限（例如readAnyDatabase）。若源库为阿里云MongoDB实例且使用自定义账号，需额外为该账号授予admin库的read权限，详情请参见实例创建时指定的root账号拥有什么权限？。

清理孤立文档

迁移数据前您需要清除源MongoDB数据库中的孤立文档。

重要

如果未清除孤立文档，将影响迁移性能，而且可能在迁移过程中会遇到_id冲突的文档，导致迁移错误的数据。

云数据库 MongoDB 版

说明

MongoDB 4.2以下大版本或4.0.6以下小版本的实例在执行清理脚本时会报错。如何查看实例当前版本，请参见MongoDB小版本说明。如何升级小版本和大版本，请参见升级数据库大版本和升级数据库小版本。

清理孤立文档需要使用cleanupOrphaned命令。在MongoDB 4.4及以上版本和MongoDB 4.2及以下版本中的使用方法略有区别，具体操作方式如下。

MongoDB 4.4及以上版本

在可以连接分片集群实例的服务器上，创建一个用于清理孤立文档的JS脚本，脚本名称为cleanupOrphaned.js。

说明

该脚本用于清理多个Shard节点的多个数据库中所有集合的孤立文档。如需清理特定集合中的孤立文档，可自行修改JS脚本来完成。

// shard实例名称列表
var shardNames = ["shardName1", "shardName2"];
// 数据库列表
var databasesToProcess = ["database1", "database2", "database3"];
shardNames.forEach(function(shardName) {
    // 遍历指定的数据库列表
    databasesToProcess.forEach(function(dbName) {
        var dbInstance = db.getSiblingDB(dbName);
        // 获取该数据库实例的所有集合名称
        var collectionNames = dbInstance.getCollectionNames();
        // 遍历每个集合
        collectionNames.forEach(function(collectionName) {
            // 完整的集合名称
            var fullCollectionName = dbName + "." + collectionName;
            // 构建 cleanupOrphaned 命令
            var command = {
                runCommandOnShard: shardName,
                command: { cleanupOrphaned: fullCollectionName }
            };
            // 执行命令
            var result = db.adminCommand(command); 
            if (result.ok) {
                print("Cleaned up orphaned documents for collection " + fullCollectionName + " on shard " + shardName);
                printjson(result);
            } else {
                print("Failed to clean up orphaned documents for collection " + fullCollectionName + " on shard " + shardName);
            }
        });
    });
});

您需要对脚本中的shardNames和databasesToProcess参数的值进行修改，具体说明如下：

shardNames：分片集群实例中待清理孤立文档的Shard节点的ID数组，您可以在实例基本信息页面的Shard列表区域获取，例如d-bp15a3796d3a****。
databasesToProcess：待清理孤立文档的数据库名称数组。

在cleanupOrphaned.js脚本所在的目录下，执行以下命令清理孤立文档。

mongo --host <Mongoshost> --port <Primaryport>  --authenticationDatabase <database> -u <username> -p <password> cleanupOrphaned.js > output.txt

参数说明如下。

参数	说明
`<Mongoshost>`	分片集群实例Mongos节点的连接地址，格式为`s-bp14423a2a51****.mongodb.rds.aliyuncs.com`。
`<Primaryport>`	分片集群实例Mongos节点的端口号，默认为3717。
`<database>`	鉴权数据库名，即数据库账号所属的数据库。
`<username>`	数据库账号。
`<password>`	数据库账号的密码。
`output.txt`	执行结果保存到output文件中。

MongoDB 4.2及以下版本

在可以连接分片集群实例的服务器上，创建一个用于清理孤立文档的JS脚本，脚本名称为cleanupOrphaned.js。

说明

该脚本用于清理多个Shard节点中指定数据库下指定集合的孤立文档。如需清理数据库中多个集合的孤立文档，您可以修改fullCollectionName参数并多次执行，也可以自行修改脚本通过遍历的方式执行。

function cleanupOrphanedOnShard(shardName, fullCollectionName) {
    var nextKey = { };
    var result;
    while ( nextKey != null ) {
        var command = {
            runCommandOnShard: shardName,
            command: { cleanupOrphaned: fullCollectionName, startingFromKey: nextKey }
        };
        result = db.adminCommand(command);
        printjson(result);
        if (result.ok != 1 || !(result.results.hasOwnProperty(shardName)) || result.results[shardName].ok != 1 ) {
            print("Unable to complete at this time: failure or timeout.")
            break
        }
        nextKey = result.results[shardName].stoppedAtKey;
    }
    print("cleanupOrphaned done for coll: " + fullCollectionName + " on shard: " + shardName)
}
var shardNames = ["shardName1", "shardName2", "shardName3"]
var fullCollectionName = "database.collection"
shardNames.forEach(function(shardName) {
    cleanupOrphanedOnShard(shardName, fullCollectionName);
});

您需要对脚本中的shardNames和fullCollectionName参数的值进行修改，具体说明如下：

shardNames：分片集群实例中待清理孤立文档的Shard节点的ID数组，您可以在实例基本信息页面的Shard列表区域获取，例如d-bp15a3796d3a****。
fullCollectionName：需要替换为待清理孤立文档的集合名称，格式为数据库名称.集合名称。

在cleanupOrphaned.js脚本所在的目录下，执行以下命令清理孤立文档。

mongo --host <Mongoshost> --port <Primaryport>  --authenticationDatabase <database> -u <username> -p <password> cleanupOrphaned.js > output.txt

参数说明如下。

参数	说明
`<Mongoshost>`	分片集群实例Mongos节点的连接地址，格式为`s-bp14423a2a51****.mongodb.rds.aliyuncs.com`。
`<Primaryport>`	分片集群实例Mongos节点的端口号，默认为3717。
`<database>`	鉴权数据库名，即数据库账号所属的数据库。
`<username>`	数据库账号。
`<password>`	数据库账号的密码。
`output.txt`	执行结果保存到output文件中。

自建MongoDB

在可以连接自建MongoDB数据库的服务器上下载cleanupOrphaned.js脚本文件。

wget "https://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/attach/120562/cn_zh/1564451237979/cleanupOrphaned.js"

修改cleanupOrphaned.js脚本文件，将test替换为待清理孤立文档的数据库名。

重要

如果您有多个数据库，您需要重复执行步骤2~步骤3。

function cleanupOrphaned(coll) {
  var nextKey = { };
  var result;
  while ( nextKey != null ) {
    result = db.adminCommand( { cleanupOrphaned: coll, startingFromKey: nextKey } );
    if (result.ok != 1)
       print("Unable to complete at this time: failure or timeout.")
    printjson(result);
    nextKey = result.stoppedAtKey;
  }
}
var dbName = 'test'
db = db.getSiblingDB(dbName)
db.getCollectionNames().forEach(function(collName) {
        cleanupOrphaned(dbName + "." + collName);
});

执行如下命令，清理Shard节点中指定数据库下所有集合的孤立文档。

说明
您需要重复执行本步骤，为每个Shard节点清理孤立文档。
```
mongo --host <Shardhost> --port <Primaryport>  --authenticationDatabase <database> -u <username> -p <password> cleanupOrphaned.js
```
说明
- <Shardhost>：Shard节点的IP地址。
- <Primaryport>：Shard节点中的Primary节点的服务端口。
- <database>：鉴权数据库名，即数据库账号所属的数据库。
- <username>：登录数据库的账号。
- <password>：登录数据库的密码。
示例：

本案例的自建MongoDB数据库有三个Shard节点，所以需要分别为这三个节点清除孤立文档。
```
mongo --host 172.16.1.10 --port 27018  --authenticationDatabase admin -u dtstest -p 'Test123456' cleanupOrphaned.js
```
```
mongo --host 172.16.1.11 --port 27021 --authenticationDatabase admin -u dtstest -p 'Test123456' cleanupOrphaned.js
```
```
mongo --host 172.16.1.12 --port 27024  --authenticationDatabase admin -u dtstest -p 'Test123456' cleanupOrphaned.js
```

操作步骤

进入目标地域的迁移任务列表页面（二选一）。
通过DTS控制台进入
1. 登录数据传输服务DTS控制台。
2. 在左侧导航栏，单击数据迁移。
3. 在页面左上角，选择迁移实例所属地域。
通过DMS控制台进入
说明
实际操作可能会因DMS的模式和布局不同，而有所差异。更多信息。请参见极简模式控制台和自定义DMS界面布局与样式。
1. 登录DMS数据管理服务。
2. 在顶部菜单栏中，选择Data + AI > 数据传输（DTS） > 数据迁移。
3. 在迁移任务右侧，选择迁移实例所属地域。
单击创建任务，进入任务配置页面。

配置源库及目标库信息。

警告

选择源和目标实例后，建议您仔细阅读页面上方显示的使用限制，否则可能会导致任务失败或数据不一致。

类别	配置	说明
无	任务名称	DTS会自动生成一个任务名称，建议配置具有业务意义的名称（无唯一性要求），便于后续识别。
源库信息	选择已有连接信息	若您需要使用已录入系统（新建或保存）的数据库实例，请在下拉列表中选择所需的数据库实例，下方的数据库信息将自动进行配置。说明 DMS控制台的配置项为选择DMS数据库实例。若您未将数据库实例录入到系统，或无需使用已录入系统的数据库实例，则需要手动配置下方的数据库信息。
	数据库类型	选择MongoDB。
	接入方式	选择云实例。
	实例地区	选择源云数据库MongoDB版所属地域。
	是否跨阿里云账号	本示例使用当前阿里云账号下的数据库实例，需选择不跨账号。
	架构类型	选择分片集群架构。副本集架构：通过部署多种节点来达到高可用和读写分离的效果，详细信息，请参见副本集架构。分片集群架构：提供Mongos、Shard和ConfigServer三种组件，可自由选择Mongos和Shard的个数和配置，详细信息，请参见分片集群架构。
	迁移方式	请根据实际情况，选择增量数据迁移的方式。 Oplog（推荐）：若源库已开启Oplog日志，则支持此选项。说明本地自建MongoDB和云数据库MongoDB版默认已开启Oplog日志，且使用此方式迁移增量数据时增量迁移任务的延迟较小（拉取日志的速度较快），因此推荐选择Oplog。 ChangeStream：若源库已开启变更流（Change Streams），则支持此选项。说明源库为Amazon DocumentDB（非弹性集群）时，仅支持选择ChangeStream。源库架构类型选择为分片集群架构，无需填写Shard账号和Shard密码。
	实例ID	选择源云数据库MongoDB版实例ID。
	鉴权数据库名称	填入源云数据库MongoDB版实例数据库账号所属的数据库名称，若未修改过则默认为admin。
	数据库账号	填入源云数据库MongoDB版的数据库账号。权限要求，请参见数据库账号的权限要求。
	数据库密码	填入该数据库账号对应的密码。
	Shard账号	当迁移方式选择为Oplog时，需要填入源云数据库MongoDB版分片集群实例Shard节点的数据库账号。说明各Shard节点的账号和密码需保持一致，且需要先申请Shard节点的连接地址。更多信息，请参见申请Shard连接地址。
	Shard密码	当迁移方式选择为Oplog时，需要填入源云数据库MongoDB版分片集群实例Shard节点的数据库密码。
	连接方式	DTS支持非加密连接、SSL安全连接和Mongo Atlas SSL三种连接方式。连接方式的选项与接入方式和架构类型有关，请以控制台为准。说明架构类型为分片集群架构，且迁移方式为Oplog的MongoDB数据库，不支持SSL安全连接。若源库为自建（接入方式不为云实例）副本集架构的MongoDB数据库，并且选择了SSL安全连接，DTS还支持上传CA证书对连接进行校验。
目标库信息	选择已有连接信息	若您需要使用已录入系统（新建或保存）的数据库实例，请在下拉列表中选择所需的数据库实例，下方的数据库信息将自动进行配置。说明 DMS控制台的配置项为选择DMS数据库实例。若您未将数据库实例录入到系统，或无需使用已录入系统的数据库实例，则需要手动配置下方的数据库信息。
	数据库类型	选择MongoDB。
	接入方式	选择云实例。
	实例地区	选择目标云数据库MongoDB版所属地域。
	是否跨阿里云账号	本示例使用当前阿里云账号下的数据库实例，需选择不跨账号。
	架构类型	根据您的业务需求选择架构，取值：副本集架构：通过部署多种节点来达到高可用和读写分离的效果，详细信息，请参见副本集架构。分片集群架构：提供Mongos、Shard和ConfigServer三种组件，可自由选择Mongos和Shard的个数和配置，详细信息，请参见分片集群架构。
	实例ID	选择目标云数据库MongoDB版实例ID。
	鉴权数据库名称	填入目标云数据库MongoDB版实例数据库账号所属的数据库名称，若未修改过则默认为admin。
	数据库账号	填入目标云数据库MongoDB版的数据库账号。权限要求，请参见数据库账号的权限要求。
	数据库密码	填入该数据库账号对应的密码。
	连接方式	DTS支持非加密连接、SSL安全连接和Mongo Atlas SSL三种连接方式。连接方式的选项与接入方式和架构类型有关，请以控制台为准。说明架构类型为分片集群架构的MongoDB数据库，不支持SSL安全连接。若目标库为自建（接入方式不为云实例）副本集架构的MongoDB数据库，并且选择了SSL安全连接，DTS还支持上传CA证书对连接进行校验。

配置完成后，在页面下方单击测试连接以进行下一步。
说明
- 请确保DTS服务的IP地址段能够被自动或手动添加至源库和目标库的安全设置中，以允许DTS服务器的访问。更多信息，请参见添加DTS服务器IP地址白名单。
- 若源库或目标库为自建数据库（接入方式不是云实例），则还需要在弹出的DTS服务器访问授权对话框单击测试连接。

配置任务对象。

在对象配置页面，配置待迁移的对象。

配置	说明
迁移类型	如果只需要进行全量迁移，建议同时选中库表结构迁移和全量迁移。如果需要进行不停机迁移，建议同时选中库表结构迁移、全量迁移和增量迁移。说明若未选中库表结构迁移，请确保目标库中存在接收数据的数据库和表，并根据实际情况，在已选择对象框中使用库表列名映射功能。若未选中增量迁移，为保障数据一致性，数据迁移期间请勿在源实例中写入新的数据。更多任务步骤信息，请参见迁移类型说明。
目标已存在表的处理模式	预检查并报错拦截：检查目标数据库中是否有同名的集合。如果目标数据库中没有同名的集合，则通过该检查项目；如果目标数据库中有同名的集合，则在预检查阶段提示错误，数据迁移任务不会被启动。说明如果目标库中同名的集合不方便删除或重命名，您可以更改该集合在目标库中的名称，请参见库表列名映射。忽略报错并继续执行：跳过目标数据库中是否有同名集合的检查项。警告选择为忽略报错并继续执行，可能导致数据不一致，给业务带来风险，例如：在目标库遇到与源库主键的值相同的记录，则会保留目标库中的该条记录，即源库中的该条记录不会迁移至目标库中。可能会导致无法初始化数据、只能迁移部分的数据或迁移失败。
目标库对象名称大小写策略	您可以配置目标实例中迁移对象的库名、集合名的英文大小写策略。默认情况下选择DTS默认策略，您也可以选择与源库、目标库默认策略保持一致。更多信息，请参见目标库对象名称大小写策略。
源库对象	在源库对象框中单击待迁移的对象，然后单击将其移动到已选择对象框。说明迁移对象的选择粒度为DATABASE、COLLECTION。
已选择对象	如需设置待迁移对象在目标实例中的名称，或指定目标实例中接收数据的对象，请右击已选择对象中的迁移对象进行修改。设置方式，请参见库表列名映射。如需移除已选择的迁移对象，请在已选择对象框中单击待迁移的对象，然后单击将其移动到源库对象框。说明如需按库或集合级别选择增量迁移的操作，请在已选择对象中右击待迁移的对象，并在弹出的对话框中进行选择。如需设置条件过滤数据（全量迁移阶段支持条件过滤数据，增量迁移阶段不支持），请在已选择对象中右击待迁移的表，并在弹出的对话框中进行设置。设置方法，请参见设置过滤条件。如果使用了对象名映射功能（指定用于接收数据的数据库或集合），可能会导致依赖这个对象的其他对象迁移失败。

单击下一步高级配置，进行高级参数配置。

配置	说明
选择调度该任务的专属集群	DTS默认将任务调度到共享集群上，您无需选择。若您希望任务更加稳定，可以购买专属集群来运行DTS迁移任务。
源库、目标库无法连接后的重试时间	在迁移任务启动后，若源库或目标库连接失败则DTS会报错，并会立即进行持续的重试连接，默认重试720分钟，您也可以在取值范围（10~1440分钟）内自定义重试时间，建议设置30分钟以上。如果DTS在设置的时间内重新连接上源、目标库，迁移任务将自动恢复。否则，迁移任务将失败。说明针对同源或者同目标的多个DTS实例，网络重试时间以后创建任务的设置为准。由于连接重试期间，DTS将收取任务运行费用，建议您根据业务需要自定义重试时间，或者在源和目标库实例释放后尽快释放DTS实例。
源库、目标库出现其他问题后的重试时间	在迁移任务启动后，若源库或目标库出现非连接性的其他问题（如DDL或DML执行异常），则DTS会报错并会立即进行持续的重试操作，默认持续重试时间为10分钟，您也可以在取值范围（1~1440分钟）内自定义重试时间，建议设置10分钟以上。如果DTS在设置的重试时间内相关操作执行成功，迁移任务将自动恢复。否则，迁移任务将会失败。重要源库、目标库出现其他问题后的重试时间的值需要小于源库、目标库无法连接后的重试时间的值。
是否限制全量迁移速率	在全量迁移阶段，DTS将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。您可以根据实际情况，选择是否对全量迁移任务进行限速设置（设置每秒查询源库的速率QPS、每秒全量迁移的行数RPS和每秒全量迁移的数据量(MB)BPS），以缓解目标库的压力。说明仅当迁移类型选择了全量迁移，才有此配置项。您也可以在迁移实例运行后，调整全量迁移的速率。
待同步的数据中，同一张表内主键_id的数据类型是否唯一	待迁移的数据中，同一个集合内主键`_id`的数据类型是否唯一。重要请根据实际情况选择，否则可能会导致数据丢失。仅当迁移类型选择了全量迁移，才有此配置项。是：唯一。在全量迁移阶段，DTS将不会扫描源库待迁移数据中主键的数据类型；在单个集合中，DTS仅会迁移一种数据类型的主键所对应的数据。否：不唯一。在全量迁移阶段，DTS将扫描源库待迁移数据中主键的数据类型，并迁移其所有数据。
是否限制增量迁移速率	您也可以根据实际情况，选择是否对增量迁移任务进行限速设置（设置每秒增量迁移的行数RPS和每秒增量迁移的数据量(MB)BPS），以缓解目标库的压力。说明仅当迁移类型选择了增量迁移，才有此配置项。您也可以在迁移实例运行后，调整增量迁移的速率。
环境标签	您可以根据实际情况，选择用于标识实例的环境标签。本示例无需选择。
配置 ETL 功能	根据业务需求选择是否配置ETL功能，对数据进行加工处理。是：配置ETL功能，您还需要在文本框中输入数据处理语句。否：不配置ETL功能。
监控告警	根据业务需求选择是否设置告警并接收告警通知。不设置：不设置告警。设置：设置告警。您还需要设置告警阈值和告警联系人，当迁移失败或延迟超过阈值后，系统将进行告警通知。

单击下一步数据校验，进行数据校验任务配置。
若您需要使用数据校验功能，配置方法请参见配置数据校验。

保存任务并进行预检查。
- 若您需要查看调用API接口配置该实例时的参数信息，请将鼠标光标移动至下一步保存任务并预检查按钮上，然后单击气泡中的预览OpenAPI参数。
- 若您无需查看或已完成查看API参数，请单击页面下方的下一步保存任务并预检查。
说明
- 在迁移任务正式启动之前，会先进行预检查。只有预检查通过后，才能成功启动迁移任务。
- 如果预检查失败，请单击失败检查项后的查看详情，并根据提示修复后重新进行预检查。
- 如果预检查产生警告：
  对于不可以忽略的检查项，请单击失败检查项后的查看详情，并根据提示修复后重新进行预检查。
  对于可以忽略无需修复的检查项，您可以依次单击点击确认告警详情、确认屏蔽、确定、重新进行预检查，跳过告警检查项重新进行预检查。如果选择屏蔽告警检查项，可能会导致数据不一致等问题，给业务带来风险。

购买实例。

预检查通过率显示为100%时，单击下一步购买。

在购买页面，选择数据迁移实例的链路规格，详细说明请参见下表。

类别	参数	说明
信息配置	资源组配置	选择实例所属的资源组，默认为default resource group。更多信息，请参见什么是资源管理。
信息配置	链路规格	DTS为您提供了不同性能的迁移规格，迁移链路规格的不同会影响迁移速率，您可以根据业务场景进行选择。更多信息，请参见数据迁移链路规格说明。

配置完成后，阅读并选中《数据传输（按量付费）服务条款》。
单击购买并启动，并在弹出的确认对话框，单击确定。
您可以在迁移任务列表页面，查看迁移实例的具体进度。
说明
- 若迁移实例不包含增量迁移任务，则迁移实例会自动结束。迁移实例自动结束后，运行状态为已完成。
- 若迁移实例包含增量迁移任务，则迁移实例不会自动结束，增量迁移任务会持续进行。在增量迁移任务正常运行期间，迁移实例的运行状态为运行中。

常见问题

为什么在没有业务写入的情况下仍然存在任务延迟和数据不一致的问题？

问题原因：由于MongoDB集合的TTL索引自动删除机制与DTS的数据同步机制存在冲突，可能导致同步/迁移任务产生延迟和数据不一致问题。原因分析如下：

增量写入时DELETE未命中数据，影响同步/迁移效率：源端TTL索引在删除过期数据时，会在Oplog中生成DELETE记录，DTS会同步该DELETE行为。如果此时目标端的TTL索引已删除相应的数据，将导致DTS在批量写入时出现DELETE未命中数据的情况，即MongoDB引擎返回的影响行数与预期行数不符，从而进入异常处理逻辑分支，影响迁移效率。

TTL索引非实时删除过期数据导致数据不一致：MongoDB的TTL索引删除数据并非实时执行，因此可能出现过期数据在源端依然存在，而在目标端已被删除的情况。这将导致数据不一致的现象。

示例案例：

由于MongoDB的Oplog/ChangeStream中对于UPDATE操作只记录被更新的字段，不记录数据更新前后所有字段的值，因此当UPDATE未命中数据时采用忽略此次UPDATE的策略。

时序	源端	目标端
1	业务INSERT数据
2		DTS同步INSERT数据
3	数据已过期但未被TTL索引删除
4	业务UPDATE数据（如：UPDATE了TTL索引字段，修改过期时间）
5		TTL索引删除数据
6		DTS同步UPDATE未命中数据，忽略此次操作

此时目标端MongoDB实例上会缺少这条数据。

解决方案：您需要在同步/迁移期间临时修改目标端TTL索引的过期时间，确保数据同步/迁移的效率与一致性。详细流程，请参见MongoDB为源时同步/迁移含TTL索引集合最佳实践。