本文介绍了用户在使用控制台或OpenAPI配置任务时系统返回的错误码、出现报错的场景及解决方法。

用户配置使用类错误码

错误码报错场景原因及解决方法

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. 单击确定1

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驱动程序数据包成功发送到源数据库服务器,但未收到来自源数据库的数据包。
  • 解决方法

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数据库的任务。

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配置任务时。
  • 原因:未配置任务步骤,即传入字段StructureInitializationDataInitializationDataSynchronization的值均为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配置任务时。

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实例释放任务

DTS.Msg.Forbidden.AliyunUIDNotFound

使用DTS控制台配置任务时,常见于配置跨账号任务或者使用RAM用户(子账号)登录。
  • 原因:登录DTS控制台的阿里云账号(主账号)信息未初始化。
    • 配置跨账号任务时,源端数据库所属的阿里云账号(主账号)从未登录过DTS控制台。
    • 使用子账号登录时,RAM用户(子账号)所属的阿里云账号(主账号)从未登录过DTS控制台。
  • 解决方法:查看弹窗报错信息中的UID,使用主账号登录DTS控制台后重试。

DTS.Msg.RamPermissionDenied

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

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分钟以上。