此介面用於查詢資料庫結構匯入任務的詳細資訊。
介面說明
CreateDataImportTask 介面用於建立資料匯入任務，支援將儲存在 OSS、ECS 或直接傳入的 SQL/CSV 檔案匯入至目標資料庫執行個體中。透過指定執行個體 ID、資料庫名稱、引擎類型、資料來源（如 OSS 路徑）及匯入類型，系統將以非同步或同步方式執行資料寫入作業，適用於資料移轉、初始化和補錄等情境，並返回任務 ID 以便後續狀態查詢與管理。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
polardbx:DescribeStructureImportTaskInfo |
none |
*全部資源。
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
執行個體所在地域。 |
cn-shanghai |
| SlinkTaskId |
string |
是 |
目標任務 ID。 |
etx-szr2rr6i***** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
1AD222E9-E606-4A42-BF6D-8A4442913CEF |
| Message |
string |
返回訊息。>請求成功時此參數為空，請求失敗時會返回請求異常資訊（如錯誤碼等）。 |
success |
| Data |
object |
返回結果集。 |
|
| StructureImportResult |
object |
結構匯入任務的匯入結果。 |
|
| Status |
string |
匯入狀態。 |
finish |
| FinishedNum |
integer |
已完成的記錄數。 |
118 |
| TotalNum |
integer |
結果總數。 |
1 |
| ExceptionFullTableName |
string |
異常的表名。 |
hash_realtime_new.wm_in_job_et |
| ExceptionDetail |
string |
異常原因。 |
java.sql.SQLException: [1a7a5f22aa403000][10.239.190.4:3058][hash_realtime_new]ERR-CODE: [TDDL-5123][ERR_INSTANCE_READ_ONLY_OPTION_NOT_SUPPORT] server is running with the instance-read-only option so it cannot execute this statement |
| Percentage |
integer |
目前進度（百分比）。 |
100 |
| SlinkStage |
string |
slink 狀態。 |
STRUCTURE_IMPORT |
| Success |
boolean |
請求是否成功。 |
true |
樣本
正常返回樣本
JSON格式
{
"RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
"Message": "success",
"Data": {
"StructureImportResult": {
"Status": "finish",
"FinishedNum": 118,
"TotalNum": 1,
"ExceptionFullTableName": "hash_realtime_new.wm_in_job_et",
"ExceptionDetail": "java.sql.SQLException: [1a7a5f22aa403000][10.239.190.4:3058][hash_realtime_new]ERR-CODE: [TDDL-5123][ERR_INSTANCE_READ_ONLY_OPTION_NOT_SUPPORT] server is running with the instance-read-only option so it cannot execute this statement",
"Percentage": 100
},
"SlinkStage": "STRUCTURE_IMPORT"
},
"Success": true
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。