調用DescribeMigrationJobDetail接口查詢數據遷移任務執(zhí)行詳情。
調用本接口時,數據遷移任務需處于遷移中、遷移失敗、暫停或遷移完成狀態(tài)。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeMigrationJobDetail |
系統(tǒng)規(guī)定參數,取值:DescribeMigrationJobDetail。 |
MigrationJobId | String | 是 | dtsta7w132u12h**** |
數據遷移實例ID,可以通過調用DescribeMigrationJobs接口查詢。 |
RegionId | String | 否 | cn-hangzhou |
數據遷移實例所在地域的ID,詳情請參見支持的地域列表。 |
PageSize | Integer | 否 | 30 |
每頁記錄數,取值: 30、50、100,默認值為30。 |
PageNum | Integer | 否 | 1 |
頁碼,取值為大于0且不超過Integer數據類型的最大值,默認值為1。 |
MigrationMode.StructureInitialization | Boolean | 否 | true |
是否查詢結構遷移詳情,取值:
|
MigrationMode.DataInitialization | Boolean | 否 | true |
是否查詢全量數據遷移詳情,取值:
|
MigrationMode.DataSynchronization | Boolean | 否 | true |
是否查詢增量數據遷移詳情,取值:
|
ClientToken | String | 否 | 0c593ea1-3bea-11e9-b96b-88e9fe63**** |
保證請求冪等性。從您的客戶端生成一個參數值,確保不同請求間該參數值唯一。ClientToken只支持ASCII字符,且不能超過64個字符。 |
AccountId | String | 否 | 12323344**** |
阿里云主賬號ID,無需設置,該參數即將下線。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
DataSynchronizationDetailList | Array of DataSynchronizationDetail |
增量數據遷移執(zhí)行詳情。 |
|
DataSynchronizationDetail | |||
DestinationOwnerDBName | String | dtstestdata |
目標實例中遷移對象所屬數據庫的名稱。 |
ErrorMessage | String | 任務失敗太久無法恢復 |
增量數據遷移失敗的錯誤提示。 |
SourceOwnerDBName | String | dtstestdata |
源實例中遷移對象所屬數據庫的名稱。 |
Status | String | Migrating |
增量數據遷移狀態(tài),返回值:
|
TableName | String | customer |
待遷移對象的表名。 |
DataInitializationDetailList | Array of DataInitializationDetail |
全量數據遷移執(zhí)行詳情。 |
|
DataInitializationDetail | |||
DestinationOwnerDBName | String | dtstestdata |
目標實例中遷移對象所屬數據庫的名稱。 |
ErrorMessage | String | java.lang.NumberFormatException: For input string: "" |
全量數據遷移失敗的錯誤提示。 |
FinishRowNum | String | 200001 |
已遷移的記錄數。 |
MigrationTime | String | 0.0 |
全量數據遷移的耗時。 |
SourceOwnerDBName | String | dtstestdata |
源實例中遷移對象所屬數據庫的名稱。 |
Status | String | Finished |
全量數據遷移狀態(tài),返回值:
|
TableName | String | customer |
待遷移對象的表名。 |
TotalRowNum | String | 201477 |
需遷移的總記錄數。 |
ErrCode | String | InternalError |
調用出錯時返回的錯誤碼。 |
ErrMessage | String | The request processing has failed due to some unknown error. |
調用錯誤時返回的錯誤信息。 |
PageNumber | Integer | 1 |
頁碼。 |
PageRecordCount | Integer | 30 |
一頁最多可展示的遷移實例數量。 |
RequestId | String | 0AE3CD0B-4148-426F-A90E-952467CC**** |
請求ID。 |
StructureInitializationDetailList | Array of StructureInitializationDetail |
結構遷移執(zhí)行詳情。 |
|
StructureInitializationDetail | |||
ConstraintList | Array of StructureInitializationDetail |
遷移對象對應的約束(例如索引、外鍵等)。 說明 只有當ObjectType為Table,且遷移對象有約束時,才會返回本參數。
|
|
StructureInitializationDetail | |||
DestinationOwnerDBName | String | dtstestdata |
目標實例中遷移對象所屬數據庫的名稱。 |
ErrorMessage | String | DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist; |
約束創(chuàng)建失敗的錯誤提示。 |
ObjectDefinition | String | CREATE SEQUENCE "public"."collections_id_seq" MINVALUE 1 MAXVALUE 9223372036854775807 START 249 INCREMENT BY 1 ; |
創(chuàng)建約束的結構語法定義。 |
ObjectName | String | customer |
遷移對象名稱。 |
ObjectType | String | Table |
遷移對象的類型,固定為Table。 |
SourceOwnerDBName | String | dtstestdata |
源實例中遷移對象所屬數據庫的名稱。 |
Status | String | Finished |
約束創(chuàng)建狀態(tài),返回值:
|
DestinationOwnerDBName | String | dtstestdata |
目標實例中待遷移對象所屬數據庫的名稱。 |
ErrorMessage | String | DTS-1020042 Execute sql error sql: DTS-1020042 Execute sql error sql: ERROR: column \"id\" named in key does not exist |
結構遷移失敗的錯誤提示。 |
ObjectDefinition | String | CREATE TABLE `dtstestdata`.`customer` (\n`runoob_id` int(10) unsigned auto_increment COMMENT '' NOT NULL , \n`runoob_title` varchar(100) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL , \n`runoob_author1216` varchar(40) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL , \n`submission_date1216` date COMMENT '' NULL \n, PRIMARY KEY (`runoob_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(觸發(fā)器)、Function(函數)、Procedure(存儲過程)、Package(包)、Default(默認值)、Rule(規(guī)則)、PlanGuide(執(zhí)行計劃)、Sequence(序列)。 |
SourceOwnerDBName | String | dtstestdata |
源實例中待遷移對象所屬數據庫的名稱。 |
Status | String | Finished |
結構遷移狀態(tài),返回值:
|
Success | String | true |
請求是否成功。 |
TotalRecordCount | Long | 1 |
總記錄數。 |
示例
請求示例
http(s)://dts.aliyuncs.com/?Action=DescribeMigrationJobDetail
&MigrationJobId=dtsta7w132u12h****
&<公共請求參數>
正常返回示例
XML
格式
<DescribeMigrationJobDetailResponse>
<DataSynchronizationDetailList>
<DataSynchronizationDetail>
<Status>Migrating</Status>
<TableName>customer</TableName>
<SourceOwnerDBName>dtstestdata</SourceOwnerDBName>
<DestinationOwnerDBName>dtstestdata</DestinationOwnerDBName>
</DataSynchronizationDetail>
</DataSynchronizationDetailList>
<RequestId>0AE3CD0B-4148-426F-A90E-952467CC****</RequestId>
<DataInitializationDetailList>
<DataInitializationDetail>
<Status>Finished</Status>
<TableName>customer</TableName>
<TotalRowNum>201477</TotalRowNum>
<MigrationTime>0.0</MigrationTime>
<SourceOwnerDBName>dtstestdata</SourceOwnerDBName>
<DestinationOwnerDBName>dtstestdata</DestinationOwnerDBName>
<FinishRowNum>200001</FinishRowNum>
</DataInitializationDetail>
</DataInitializationDetailList>
<Success>true</Success>
<StructureInitializationDetailList>
<StructureInitializationDetail>
<Status>Finished</Status>
<ObjectType>Table</ObjectType>
<ObjectDefinition>CREATE TABLE `dtstestdata`.`customer` (
`runoob_id` int(10) unsigned auto_increment COMMENT '' NOT NULL ,
`runoob_title` varchar(100) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL ,
`runoob_author1216` varchar(40) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL ,
`submission_date1216` date COMMENT '' NULL
, PRIMARY KEY (`runoob_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>
</StructureInitializationDetail>
</StructureInitializationDetailList>
</DescribeMigrationJobDetailResponse>
JSON
格式
{
"DataSynchronizationDetailList": {
"DataSynchronizationDetail": [
{
"Status": "Migrating",
"TableName": "customer",
"SourceOwnerDBName": "dtstestdata",
"DestinationOwnerDBName": "dtstestdata"
}
]
},
"RequestId": "0AE3CD0B-4148-426F-A90E-952467CC****",
"DataInitializationDetailList": {
"DataInitializationDetail": [
{
"Status": "Finished",
"TableName": "customer",
"TotalRowNum": "201477",
"MigrationTime": "0.0",
"SourceOwnerDBName": "dtstestdata",
"DestinationOwnerDBName": "dtstestdata",
"FinishRowNum": "200001"
}
]
},
"Success": true,
"StructureInitializationDetailList": {
"StructureInitializationDetail": [
{
"Status": "Finished",
"ObjectType": "Table",
"ObjectDefinition": "CREATE TABLE `dtstestdata`.`customer` (\n`runoob_id` int(10) unsigned auto_increment COMMENT '' NOT NULL , \n`runoob_title` varchar(100) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL , \n`runoob_author1216` varchar(40) CHARSET `utf8` COLLATE `utf8_general_ci` COMMENT '' NOT NULL , \n`submission_date1216` date COMMENT '' NULL \n, PRIMARY KEY (`runoob_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"
}
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。