調用DescribeInitializationStatus查詢同步初始化詳情,即待同步對象的結構和存量資料初始化到目標庫的情況。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
| Action | String | 是 | DescribeInitializationStatus | 系統規定參數,取值:DescribeInitializationStatus。 |
| SynchronizationJobId | String | 是 | dtsi76118o3w92**** | 資料同步執行個體ID,可以通過調用DescribeSynchronizationJobs介面查詢。 |
| RegionId | String | 否 | cn-hangzhou | 資料同步執行個體所在地區的ID,詳情請參見支援的地區列表。 |
| PageSize | Integer | 否 | 30 | 每頁記錄數,取值:1~100,預設值為30。 |
| PageNum | Integer | 否 | 1 | 頁碼,取值為大於0且不超過Integer資料類型的最大值,預設值為1。 |
| AccountId | String | 否 | 12323344**** | 阿里雲主帳號ID,無需設定,該參數即將下線。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| DataInitializationDetails | Array of DataInitializationDetail | 全量資料初始化詳情。 |
|
| DestinationOwnerDBName | String | dtstestdata | 目標執行個體中待同步對象所屬資料庫的名稱。 |
| ErrorMessage | String | java.lang.NumberFormatException: For input string: "" | 全量資料初始化失敗時返回對應的失敗資訊。 |
| FinishRowNum | String | 9993 | 已完成同步的行數。 說明 該參數表示實際同步的總行數,而參數TotalRowNum的值來源於同步開始前源庫的系統資料表,由於同步時間差,會導致兩者的值會有出入。 |
| SourceOwnerDBName | String | dtstestdata | 源執行個體中待同步對象所屬資料庫的名稱。 |
| Status | String | Finished | 全量資料初始化的狀態,傳回值:
|
| TableName | String | customer | 同步對象的表名。 |
| TotalRowNum | String | 9981 | 需同步的總行數。 說明 該參數的值來源於同步開始前源庫的系統資料表,而參數FinishRowNum表示實際同步的總行數,由於同步時間差,會導致兩者的值會有出入。 |
| UsedTime | String | 0.0 | 全量同步初始化的耗時。 |
| DataSynchronizationDetails | Array of DataSynchronizationDetail | 增量資料同步詳情。 說明 該參數合集及包含的返回參數即將下線。 |
|
| DestinationOwnerDBName | String | dtstestdata | 目標執行個體中待同步對象所屬資料庫的名稱。 |
| ErrorMessage | String | 任務失敗太久無法恢複 | 增量資料同步失敗時返回對應的失敗資訊。 |
| SourceOwnerDBName | String | dtstestdata | 源執行個體中待同步對象所屬資料庫的名稱。 |
| Status | String | Migrating | 增量資料同步的狀態,傳回值:
|
| TableName | String | customer | 同步對象的表名。 |
| ErrCode | String | InternalError | 調用出錯時返回的錯誤碼。 |
| ErrMessage | String | The request processing has failed due to some unknown error. | 調用錯誤時返回對應的錯誤資訊。 |
| RequestId | String | 150DECD9-13FF-4929-A5DE-855BE9CC**** | 請求ID。 |
| StructureInitializationDetails | Array of StructureInitializationDetail | 結構初始化詳情。 |
|
| Constraints | Array of StructureInitializationDetail | 同步對象對應的約束(例如索引、外鍵等)。 說明 只有ObjectType為Table,且同步對象有約束,才會返回本參數。 |
|
| DestinationOwnerDBName | String | dtstestdata | 目標執行個體中待同步對象所屬資料庫的名稱。 |
| ErrorMessage | String | DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist | 約束建立失敗的錯誤提示。 |
| ObjectDefinition | String | CREATE SEQUENCE "public"."collections_id_seq" MINVALUE 1 MAXVALUE 9223372036854775807 START 249 INCREMENT BY 1 ; | 建立約束的結構文法定義。 |
| ObjectName | String | customer | 該同步對象的名稱。 |
| ObjectType | String | Table | 同步對象的類型,固定為Table。 |
| SourceOwnerDBName | String | dtstestdata | 源執行個體中待同步對象所屬資料庫的名稱。 |
| Status | String | Finished | 約束建立狀態,傳回值:
|
| DestinationOwnerDBName | String | dtstestdata | 目標執行個體中待同步對象所屬資料庫的名稱。 |
| ErrorMessage | String | DTS-1020042 Execute sql error sql: Table 'customer' already exists | 結構初始化失敗時返回對應的失敗資訊。 |
| ObjectDefinition | String | CREATE TABLE `dtstestdata`.`customer` (\n`customer_id` int(10) unsigned auto_increment COMMENT '' NOT NULL , \n`customer_title` varchar(100) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL , \n`customer_company1216` varchar(40) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL , \n`submission_date1216` date COMMENT '' NULL \n, PRIMARY KEY (`customer_id`)) engine=InnoDB AUTO_INCREMENT=200001 DEFAULT CHARSET=`utf8` DEFAULT COLLATE `utf8_general_ci` ROW_FORMAT= Dynamic comment = '' ;\n | 同步對象的結構文法定義。 |
| ObjectName | String | customer | 同步對象的名稱。 |
| ObjectType | String | Table | 同步對象的類型。傳回值如下: Table(表)、Constraint(約束)、Index(索引)、View(視圖)、Materialize View(物化視圖)、Type(自訂類型)、Synonym(同義字)、Trigger(觸發器)、Function(函數)、Procedure(預存程序)、Package(包)、Default(預設值)、Rule(規則)、PlanGuide(執行計畫)、Sequence(序列)。 |
| SourceOwnerDBName | String | dtstestdata | 源執行個體中待同步對象所屬資料庫的名稱。 |
| Status | String | Finished | 結構初始化的狀態。傳回值:
|
| Success | String | true | 請求是否成功。 |
樣本
請求樣本
http(s)://dts.aliyuncs.com/?Action=DescribeInitializationStatus
&SynchronizationJobId=dtsi76118o3w92****
&<公用請求參數>
正常返回樣本
XML格式
<DescribeInitializationStatusResponse>
<StructureInitializationDetails>
<Status>Finished</Status>
<ObjectType>Table</ObjectType>
<ObjectDefinition>CREATE TABLE `dtstestdata`.`customer` (
`customer_id` int(10) unsigned auto_increment COMMENT '' NOT NULL ,
`customer_title` varchar(100) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL ,
`customer_author1216` varchar(40) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL ,
`submission_date1216` date COMMENT '' NULL
, PRIMARY KEY (`customer_id`)) engine=InnoDB AUTO_INCREMENT=200001 DEFAULT CHARSET=`utf8` DEFAULT COLLATE `utf8_general_ci` ROW_FORMAT= Dynamic comment = '' ;
</ObjectDefinition>
<SourceOwnerDBName>dtstestdata</SourceOwnerDBName>
<DestinationOwnerDBName>dtstestdata</DestinationOwnerDBName>
<ObjectName>customer</ObjectName>
</StructureInitializationDetails>
<RequestId>150DECD9-13FF-4929-A5DE-855BE9CC****</RequestId>
<DataInitializationDetails>
<Status>Finished</Status>
<TableName>customer</TableName>
<TotalRowNum>9981</TotalRowNum>
<UsedTime>0.0</UsedTime>
<SourceOwnerDBName>dtstestdata</SourceOwnerDBName>
<DestinationOwnerDBName>dtstestdata</DestinationOwnerDBName>
<FinishRowNum>9993</FinishRowNum>
</DataInitializationDetails>
<Success>true</Success>
</DescribeInitializationStatusResponse>
JSON格式
{
"StructureInitializationDetails": [
{
"Status": "Finished",
"ObjectType": "Table",
"ObjectDefinition": "CREATE TABLE `dtstestdata`.`customer` (\n`customer_id` int(10) unsigned auto_increment COMMENT '' NOT NULL , \n`customer_title` varchar(100) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL , \n`customer_author1216` varchar(40) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL , \n`submission_date1216` date COMMENT '' NULL \n, PRIMARY KEY (`customer_id`)) engine=InnoDB AUTO_INCREMENT=200001 DEFAULT CHARSET=`utf8` DEFAULT COLLATE `utf8_general_ci` ROW_FORMAT= Dynamic comment = '' ;\n",
"SourceOwnerDBName": "dtstestdata",
"DestinationOwnerDBName": "dtstestdata",
"ObjectName": "customer"
}
],
"RequestId": "150DECD9-13FF-4929-A5DE-855BE9CC****",
"DataInitializationDetails": [
{
"Status": "Finished",
"TableName": "customer",
"TotalRowNum": "9981",
"UsedTime": "0.0",
"SourceOwnerDBName": "dtstestdata",
"DestinationOwnerDBName": "dtstestdata",
"FinishRowNum": "9993"
}
],
"Success": true
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。