数据传输服务 DTS：配置任务常见错误码及排查方法

错误码

报错场景

原因及解决方法

DTS.Msg.LXCreateOrderError

购买DTS实例时创建订单不成功。

• 原因：未将UID添加至白名单，无法购买跨境同步实例。

• 解决方法：开通跨境同步权限后重新购买，详情请参见申请跨境数据同步权限。

DTS.Msg.InvalidParameter.KafkaHostInvalid

配置目标库实例的接入方式为专线/VPN网关/智能网关的Kafka同步或迁移任务。

• 原因：IP地址一栏输入为域名形式。

• 解决方法：IP地址一栏目前仅支持IP地址形式，请重新输入正确的内网IP地址。

DTS.Msg.InvalidParameter.KafkaBrokerInvalid

配置目标库为ECS自建的Kafka任务。

• 原因：不支持Kafka节点配置为域名形式。

• 解决方法：请正确配置Kafka节点。配置形式如下：

  listeners= 协议://内网IP:端口
  advertised_listeners= 协议://内网IP:端口

DTS.Msg.OperationDenied.JobStatusModifying

使用API调用ModifyDtsJob接口修改同步任务。

• 原因：当前任务所属实例处于修改同步对象阶段。

• 解决方法：等待同步对象修改完成，且该任务所属实例的状态为运行中后再重试。

DTS.Msg.InvalidParameter.AliyunUidFormat

跨账号同步时，单击展示数据库实例。

• 原因：源数据库实例所属的阿里云用户ID填写不规范。

• 解决方法：填写规范的阿里云账号。

DTS.Msg.DuplicateAccount.RDSSqlServer

配置源或目标库为SQL Server数据库。

• 原因：实例已配置过DTS任务或为克隆实例。

• 解决方法：请联系技术支持解决。

DTS.Msg.SrcLink.InternetAddressNotFound

配置跨地域迁移任务。

• 原因：源数据库实例未开通公网地址。

• 解决方法：请为源数据库实例开通公网地址或使用同步任务。

DTS.Msg.UpdateJob.OperationDenied.InitStatus

重复配置任务。

• 原因：重复配置已启动的同步任务。

• 解决方法：请重置任务或修改同步对象。

  警告

  重置任务后，已配置的任务数据会丢失，请谨慎操作。

DTS.Msg.Throttling.User

使用任何功能都可能报此错误。

• 原因：当前接口请求次数已经达到阈值。

• 解决方法：请在15s～30s后重新发起请求。

DTS.Msg.LXCreateOrder.NotFoundPricePlan

购买DTS实例时，创建订单不成功。

• 原因：调用API时填写的购买参数错误或暂不支持购买此类型实例。

• 解决方法：请检查填写的参数信息是否正确，如确定无误，请联系技术支持解决。

DTS.Msg.LXPayOrder.InsufficientBalance

购买DTS实例时，支付订单不成功。

• 原因：账户余额不足，无法完成支付。

• 解决方法：请充值后重试。

DTS.Msg.CheckStatus.InvalidInitStatus

使用修改同步对象功能。

• 原因：同步任务尚未配置。

• 解决方法：请在修改任务前完成配置任务。

DTS.Msg.DRDSInvokeFail.DatabaseAuthorizationFailed

配置PolarDB-X云原生分布式数据库（原DRDS）的同步任务时报错。报错信息类似于以下形式：

can not getTableTopology (drds****,ib_ibos****)
Could not connect to address=(host=100.100.XX.XX)(port=****)(type=master) : (conn=****) [10.0.1.1:3306]
Access denied for user 'ib_ibos****'@'100.104.XX.XX' to database 'ib_ibos****')

• 原因：输入的数据库账号缺少某个库的权限。

• 解决方法：手动添加或修改库权限。步骤如下：

  1. 登录PolarDB-X控制台。

  2. 选择左侧导航栏中的实例列表，单击您所创建实例的实例名称。

  3. 进入实例管理页面，选择配置与管理 > 账号管理。

  4. 选择创建的数据库账号，单击操作列的修改权限，在弹框中添加或修改库权限。

  5. 单击确定。

DTS.Msg.DescribeColumns.TimeOut

获取源数据库列信息失败，常见于目标库为云原生数据仓库 AnalyticDB MySQL 版的任务。

• 原因：源库列过多或源库读取速度过慢，导致获取源库Schema超时。

• 解决方法：

  • 使用API进行配置。

  • 检验源库的读取速度。

DTS.Msg.DescribeStruct.TimeOut

测试链接通过后获取源库库表。

• 原因：源库过多、源库表过多或者源库读取速度过慢，导致获取源库Schema超时。

• 解决方法：

  • 配置源库对象时以库为粒度，不获取详细的表信息。

  • 使用API进行配置。

  • 检验源库的读取速度。

DTS.Msg.DRDSErrExecuteOnMySQL.ClientVersionTooLow

配置源库为PolarDB-X云原生分布式数据库（原DRDS）的任务。

• 原因：PolarDB-X云原生分布式数据库客户端版本过低。

• 解决方法：升级PolarDB-X云原生分布式数据库客户端。

DTS.Msg.DbTypeNotSupport.OnlyReadRDS

配置源库为PolarDB-X云原生分布式数据库（原DRDS）的任务。

• 原因：源数据库实例为实例类型是只读实例的PolarDB-X实例，暂不支持该PolarDB-X实例。

• 解决方法：源数据库更换为实例类型是主实例的PolarDB-X实例。

DTS.Msg.DbTypeNotSupport.PolarDBRDS

配置源库为PolarDB-X云原生分布式数据库（原DRDS）的任务。

• 原因：源数据库实例为存储类型是POLARDB的PolarDB-X实例，暂不支持该PolarDB-X实例。

• 解决方法：源数据库更换为存储类型是RDS MySQL的PolarDB-X实例。

DTS.Msg.OperationDenied.NotPurchased

调用API接口启动任务失败。

• 原因：启动尚未购买的任务。

• 解决方法：购买任务后再启动。

DTS.Msg.CheckJobFailed.ServerUnAvailable

配置任务过程中。

• 原因：由于系统无法连接任务运行的服务器节点，导致无法检测服务器节点到源或目标库的网络是否通畅。

• 解决方法：请联系技术支持解决。

DTS.Msg.StopJobFailed.ServerUnAvailable

配置任务过程中。

• 原因：逻辑上需要暂停任务时，系统无法连接任务运行的服务器节点。

• 解决方法：请联系技术支持解决。

DTS.Msg.SQLExecuteError.JDBC4CommunicationsException

测试链接通过后获取源库库表。

• 原因：通讯链路故障，JDBC驱动程序数据包成功发送到源数据库服务器，但未收到来自源数据库的数据包。

• 解决方法：

  • 排查数据库的连接数是否过多。

  • 参考communications link failure处理。

  • 联系技术支持解决。

DTS.Msg.SQLExecuteError.ConnectionRefused

测试链接通过后获取源库库表。

• 原因：获取源数据库链接被拒绝。

• 解决方法：

  • 检查监听器（Listener Process）是正常运行，配置否正确。

  • 检查负载是否过高。

  • 联系技术支持解决。

DTS.Msg.GetKafkaMetaInfo.NoAvailableBroker

配置目标库Kafka实例的版本为1.0及以上。

• 原因：

  • 数据库账号或密码错误。

  • 无法从Kafka服务端获取MetaInfo。

• 解决方法：

  • 请正确填写数据库账号和密码信息。若Kafka实例未开启验证，则无需填写数据库账号和密码。

  • 检查服务端bootstrap.servers参数是否设置正确。

  • 检查目标库信息的Kafka版本是否选择正确。

  • 检查网络是否通畅。

DTS.Msg.GetMongoDbShardInfo.EmptyInstances

配置源库或目标库为分片副本集的MongoDb数据库的任务。

• 原因：无法获取分片信息。

• 解决方法：检查配置参数，确认数据库确实为分片MongoDb。

DTS.Msg.GetMongoDbShardInfo.NoShardAddress

配置源库或目标库为分片副本集的MongoDb数据库的任务。

• 原因：无法获取分片信息。

• 解决方法：检查配置参数，确认数据库确实为分片MongoDb，并且已参考申请Shard或ConfigServer节点连接地址开通Shard地址。

DTS.Msg.SuspendDenied.JobStatusModifying

暂停任务或者批量暂停任务。

• 原因：为避免数据不一致，当任务处于修改同步对象中时，无法暂停任务。

• 解决方法：

  • 单个暂停任务：等待修改同步对象状态结束。

  • 批量暂停任务：将处于修改同步对象状态中的任务去掉，或等待修改同步对象状态结束。

DTS.Msg.ModifyDenied.JobStatusNotRunning

修改暂停中任务的同步对象。

• 原因：为避免数据不一致，当任务处于修改同步对象中时，无法修改暂停中任务的同步对象。

• 解决方法：启动任务，等待任务正常运行再修改同步对象。

  说明

  若任务延迟大于10分钟，请勿进行修改同步对象操作。

DTS.Msg.LXPayOrder.AmountLimitExceeded

配置任务后支付订单失败。

• 原因：有POC标签的账号的订单支付金额只能是0，订单的金额大于0时无法支付。

• 解决方法：

  • 支付时使用代金券，使支付金额为0。

  • 使用其他账号支付。

  说明

  支付失败的订单不可以继续支付，需要在用户中心取消。

DTS.Msg.LXPayOrder.AccountBookNotExists

配置任务后支付订单失败。

• 原因：未开通阿里云资金账户或者账户余额不足。

• 解决方法：给账户充值以开通阿里云资金账户，并确认余额充足，然后重新购买。

  说明

  支付失败的订单不可以继续支付，需要在用户中心取消。

DTS.Msg.ConfigJob.NoneSelectedStep

使用API配置任务时。

• 原因：未配置任务步骤，即传入字段StructureInitialization、DataInitialization、DataSynchronization的值均为false。

• 解决方法：传入正确的参数值以配置任务步骤。

DTS.Msg.ConfigJob.InvalidDbListFormat

使用API配置任务时。

• 原因：传入的DbList字段不是标准的JSON字符串。

• 解决方法：传入正确形式的字符串参数。

DTS.Msg.ConfigJob.InvalidReserveFormat

使用API配置任务时。

• 原因：传入的Reserve字段不是标准的JSON字符串。

• 解决方法：传入正确形式的字符串参数。

DTS.Msg.DistributedDatabaseNodesError

以先购买再配置的方式，购买源库为分布式数据库的同步实例时。

• 原因：购买实例的源数据库参数分布式数据库节点数量与实际数量不符。

• 解决方法：购买实例时选择与实际相符的分布式数据库节点数量。

DTS.Msg.LXQueryOrder.NotFoundNormalOrder

对实例进行升降配或者转换支付方式时。

• 原因：

  • 操作的实例为已完成但未释放短期实例。

  • 操作的实例已经释放但仍然在控制台上显示。

• 解决方法：

  • 释放已完成的短期实例。

  • 若实例已经释放但仍然在控制台上显示，请联系技术支持解决。

DTS.Msg.GetSSLInfo.NoSSLConn

配置任务时勾选了SSL安全连接。

• 原因：当前数据库实例未开通SSL连接，无SSL地址。

• 解决方法：给数据库实例开通SSL或者选择非加密连接。

DTS.Msg.ModifyDynamicConfig.InvalidStatus

修改已购买的同步或迁移实例的性能时。

• 原因：当前任务状态不是运行中。

• 解决方法：请确保任务在运行中再进行操作。

DTS.Msg.TransferInstanceClass.NoPermission

用户对实例进行降配操作时。

• 原因：执行降配操作的账号权限不足。

• 解决方法：请联系技术支持添加降配操作的权限，执行操作的账号及所属主账号均需要添加权限。

DTS.Msg.OperationDenied.ConsumerGroupOutOfUsage

为订阅实例创建消费组时。

• 原因：当前订阅实例的消费组已经超过20个。

• 解决方法：请根据业务需求删除不使用的消费组后重试。

DTS.Msg.GrantAccessAlreadyExists

配置DTS任务过程中。

• 原因：偶发性错误。

• 解决方法：请重试，若仍然报错请联系技术支持解决。

DTS.Msg.DbListIsEmpty

使用API配置任务时。

• 原因：传入的DbList字段为null或传入的内容等效于null。

• 解决方法：参考迁移、同步或订阅对象说明传入正确的DbList字段。

DTS.Msg.GetRedisNodes.NotCluster

配置源或目标实例为Redis的任务时。

• 原因：选择的实例模式与实例不符。

• 解决方法：选择与实例相符的实例模式。

DTS.Msg.InvalidDestinationEndPointRegion

使用API配置任务时。

• 原因：传入的目标实例地域错误或不支持。

• 解决方法：参考支持的地域列表的Region ID列传入正确的地域信息。

DTS.Msg.InvalidSourceEndPointRegion

使用API配置任务时。

• 原因：传入的源实例地域错误或不支持。

• 解决方法：参考支持的地域列表的Region ID列传入正确的地域信息。

DTS.Msg.AdminAccountExists

配置DTS任务过程中。

• 原因：DTS会在部分类型的源端数据库中创建一个固定的高权限账号，若您的数据库已经存在了同名的账号则会报错。

• 解决方法：请联系技术支持解决。

DTS.Msg.NotSupportModify

使用ModifyDtsJob接口修改任务时。

• 原因：传入的DtsInstanceId参数为迁移实例的ID。

• 解决方法：当前迁移任务仅支持在控制台修改ETL配置，若您需要修改迁移任务的其他配置，您可以创建新任务。

DTS.Msg.PrePayNotAllowDelete

使用API释放DTS任务时。

• 原因：包年包月（预付费）任务不支持直接释放。

• 解决方法：包年包月（预付费）任务暂不支持释放。

DTS.Msg.Forbidden.AliyunUIDNotFound

使用DTS控制台配置任务时，常见于配置跨账号任务或者使用RAM用户（子账号）登录。

• 原因：登录DTS控制台的阿里云账号（主账号）信息未初始化。

  • 配置跨账号任务时，源端数据库所属的阿里云账号（主账号）从未登录过DTS控制台。

  • 使用子账号登录时，RAM用户（子账号）所属的阿里云账号（主账号）从未登录过DTS控制台。

• 解决方法：查看弹窗报错信息中的UID，使用主账号登录DTS控制台后重试。

DTS.Msg.RamPermissionDenied

使用RAM用户（子账号）登录DTS控制台进行操作时。

• 原因：RAM用户（子账号）权限不足。

• 解决方法：请参考通过系统策略授权子账号管理DTS或数据传输自定义权限策略参考，为RAM用户（子账号）授权后重试。

  说明

  创建自定义策略填入具体权限策略信息时，需要使用错误提示信息中的Action（接口操作名称）和ResourcedId（DTS实例ID）。

  

DTS.Msg.EcsJoinSecurityGroupLimitExceeded

配置数据源为ECS自建数据库的任务时。

• 原因：ECS实例的安全组超过五个。

• 解决方法：请根据业务需求并参考移出安全组，移出ECS实例中多余的安全组后重试。

  说明

  若由于业务需求安全组均无法移出，请整合ECS实例的安全组，使安全组数量不超过五个。

DTS.Msg.UpgradeTrialTimesLimit

体验RPS上限升级功能时。

• 原因：当前账号体验RPS上限升级功能的次数已经超过了限制。每个账号有3次体验机会，每次体验持续24小时。

• 解决方法：无。

DTS.Msg.HasRunningTrial

体验RPS上限升级功能时。

• 原因：DTS实例已在体验RPS上限升级功能中，不能重复体验。

• 解决方法：无。

DTS.Msg.DtsInstanceHasNoLimit

体验RPS上限升级功能时。

• 原因：DTS实例没有RPS限制，不能体验RPS上限升级功能。

• 解决方法：无。

DTS.Msg.UpgradeTrialInvalidJobStatus

体验RPS上限升级功能时。

• 原因：DTS实例状态不能体验RPS上限升级功能，仅运行中、已暂停或失败状态时支持体验此功能。

• 解决方法：无。

DTS.Msg.InvalidMigrationJobId

使用API配置任务时。

• 原因：传入的任务ID不正确或者任务已经被删除。

• 解决方法：传入正确的参数后重试。

DTS.Msg.InvalidIpAddress

配置接入方式为公网IP、专线/VPN网关/智能网关或云企业网CEN的数据库实例的DTS任务时。

• 原因：输入的IP地址格式错误，导致无法解析。

• 解决方法：输入正确的IP地址后重试。

DTS.Msg.PauseDenied.JobStatusNotRunning

暂停任务时。

• 原因：需要暂停的任务状态不是运行中（如失败、已暂停或者初始化中）。

• 解决方法：修复或等待任务状态为运行中时，再暂停任务。

DTS.Msg.CheckpointOutOfAdjustableRange

修改实例增量写入阶段的位点时。

• 原因：指定的位点不在可修改范围内。

• 解决方法：在可修改的范围内修改位点。

DTS.Msg.MaxRetryTime.Invalid

修改源库、目标库无法连接后的重试时间时。

• 原因：修改的值不在取值范围内（10~1440分钟）。

• 解决方法：在取值范围内修改源库、目标库无法连接后的重试时间，建议设置为30分钟以上。