配置任務常見錯誤碼及排查方法

錯誤碼

報錯情境

原因及解決方案

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. 單擊確定。彈框左側為資料庫列表，右側為已授權資料庫列表，通過授權和移除按鈕在兩側之間移動資料庫，並為每個已授權資料庫選擇權限類別型（讀寫、唯讀、僅DDL或僅DML），完成後單擊確定。

DTS.Msg.DescribeColumns.TimeOut

擷取來源資料庫列資訊失敗，常見於目標庫為AnalyticDB for 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串連地址開通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（介面操作名稱）和ResourceId（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網關/智能網關或Cloud Enterprise NetworkCEN的資料庫執行個體的DTS任務時。

• 原因：輸入的IP地址格式錯誤，導致無法解析。

• 解決方案：輸入正確的IP地址後重試。

DTS.Msg.PauseDenied.JobStatusNotRunning

暫停任務時。

• 原因：需要暫停任務狀態不是運行中（如失敗、已暫停或者初始化中）。

• 解決方案：修複或等待任務狀態為運行中時，再暫停任務。

DTS.Msg.CheckpointOutOfAdjustableRange

修改執行個體增量寫入階段的位點時。

• 原因：指定的位點不在可修改範圍內。

• 解決方案：在可修改的範圍內修改位點。

DTS.Msg.MaxRetryTime.Invalid

修改源庫、目標庫無法串連後的重試時間時。

• 原因：修改的值不在取值範圍內（10~1440分鐘）。

• 解決方案：在取值範圍內修改源庫、目標庫無法串連後的重試時間，建議設定為30分鐘以上。