CreateDataImportTask - PolarDB

用於建立一個資料匯入任務，將外部資料檔案（如 SQL 指令碼、CSV 檔案等）匯入到目標資料庫執行個體中。

介面說明

CreateDataImportTask 介面用於建立資料匯入任務，支援將儲存在 OSS、ECS 或直接傳入的 SQL/CSV 檔案匯入到目標資料庫執行個體中。透過指定執行個體 ID、資料庫名稱、引擎類型、資料來源（如 OSS 路徑）及匯入類型，系統將以非同步或同步方式執行資料寫入操作，適用於資料移轉、初始化和補錄等場景，並返回任務 ID 以便後續狀態查詢與管理。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

polardbx:CreateDataImportTask

none

*全部資源。

*

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	執行個體所在地域。>您可以呼叫 describeregions 介面檢視 PolarDB-X 支援的地域詳情，包括地域 ID。	cn-hangzhou
DBInstanceName	string	否	執行個體 ID。>您可以呼叫 describedbinstances 介面檢視目標地域下所有執行個體的詳情，包括執行個體 ID。	pxc-********
SrcResId	string	否	來源 RDS 執行個體 ID。>您可以呼叫 describedrivingaccess 介面檢視目標地域下所有來源 RDS 執行個體的詳情，包括執行個體 ID。	pxc-shrnv****kh87z
SrcDb	string	否	當來源資料庫為 RDS MySQL 時，移轉來源的資料庫資訊。>來源資料庫必須與目標資料庫保持一致。	transfer_for_st
SrcUserName	string	否	來源端使用者名稱。	drds_test
SrcPassword	string	否	來源端執行匯入任務的讀寫模式，取值範圍如下：rw：讀寫。ro：唯讀。	******
DstResId	string	否	移轉任務 ID。	pxc-shr8****k36vrn
DstDb	string	否	匯入目標 SQL 的執行環境，取值範圍如下：*importing：匯入中。*success：匯入成功。*fail：匯入失敗。	transfer_test3
DstUserName	string	否	目標端使用者名稱。	bbt_cms_prod
DstPassword	string	否	目標 RDS 執行個體高權限帳號的密碼。>您可以呼叫 describedbinstances 介面檢視目標執行個體的高權限帳號資訊，包括密碼。僅當 [unk]dstpassword=true[unk] 時，此參數生效。	******
SlinkTaskId	string	是	匯入任務 ID。	etx-szr2rr6i*****

返回參數

名稱	類型	描述	樣本值
	object
Message	string	請求返回訊息。	*****
RequestId	string	請求 ID。	173CA69A-3513-591D-8A09-C1EA37CBE2D9
Success	boolean	請求是否成功。	true
Data	object	返回結果。
SlinkTaskId	string	匯入任務 ID。	etx-szr2rr6i*****

樣本

正常返回樣本

JSON格式

{
  "Message": "*****",
  "RequestId": "173CA69A-3513-591D-8A09-C1EA37CBE2D9",
  "Success": true,
  "Data": {
    "SlinkTaskId": "etx-szr2rr6i*****"
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。