查詢一個資料同步執行個體狀態 - Data Transmission Service

調試

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

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	DescribeSynchronizationJobStatus	系統規定參數，取值：DescribeSynchronizationJobStatus。
SynchronizationJobId	String	是	dtsexjk1alb116****	資料同步執行個體ID，可以通過調用DescribeSynchronizationJobs介面查詢。
RegionId	String	否	cn-hangzhou	資料同步執行個體所在地區的ID，詳情請參見支援的地區列表。
SynchronizationDirection	String	否	Forward	同步方向，取值： Forward：正向。 Reverse：反向。說明預設取值為Forward。只有當資料同步執行個體的同步拓撲為雙向同步時，本參數傳入Reverse才會生效。
ClientToken	String	否	0c593ea1-3bea-11e9-b96b-88e9fe63****	保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken只支援ASCII字元，且不能超過64個字元。
AccountId	String	否	12323344****	阿里雲主帳號ID，無需設定，該參數即將下線。

返回資料

名稱	類型	樣本值	描述
Checkpoint	String	1610616144	同步最新一條資料的時間戳記，格式為Unix時間戳記。說明 Unix時間戳記轉換工具可用搜尋引擎擷取。
DataInitialization	String	true	是否執行全量資料初始化，取值： true：是。 false：否。
DataInitializationStatus	Struct		全量資料初始化狀態。
ErrorMessage	String	java.lang.NumberFormatException: For input string: ""	全量資料初始化失敗的錯誤提示。
Percent	String	100	全量資料初始化進度，單位為百分比。
Progress	String	200001	已完成全量資料初始化的記錄數。
Status	String	Finished	全量資料初始化狀態，取值包括： NotStarted：未啟動。 Migrating：初始化中。 Failed：初始化失敗。 Finished：初始化完成。
DataSynchronizationStatus	Struct		增量資料同步狀態。
Checkpoint	String	1610709865	同步最新一條資料的時間戳記，格式為Unix時間戳記。
Delay	String	0	增量資料同步延遲，單位為秒。
DelayMillis	Long	856	增量資料同步延遲，單位為毫秒。
ErrorMessage	String	任務失敗太久無法恢複	增量資料同步失敗的錯誤提示。
Percent	String	100	增量資料同步進度，單位為百分比。
Status	String	Finished	增量資料同步狀態，取值包括： NotStarted：未啟動。 Migrating：同步中。 Failed：同步失敗。 Finished：同步完成。
Delay	String	0	同步延遲，單位為秒。
DelayMillis	Long	506	同步延遲，單位為毫秒。
DestinationEndpoint	Struct		目標執行個體的串連資訊。
EngineName	String	MySQL	目標執行個體的資料庫類型。
IP	String	172.16.88.***	目標執行個體的串連地址。
InstanceId	String	rm-bp162d4tp0500****	目標執行個體ID。
InstanceType	String	RDS	目標執行個體類型。
Port	String	3306	目標執行個體的資料庫服務連接埠。
UserName	String	dtstest	目標執行個體的資料庫帳號。
ErrCode	String	InternalError	調用出錯時返回的錯誤碼。
ErrMessage	String	The request processing has failed due to some unknown error.	調用錯誤時返回的錯誤資訊。
ErrorMessage	String	DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\n\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].	資料同步失敗的錯誤提示。
ExpireTime	String	2021-03-07T16:00:00Z	同步執行個體的到期時間，yyyy-MM-ddTHH:mm:ssZ（UTC時間）。說明當PayType參數的傳回值為PrePaid時才會返回本參數。
PayType	String	PrePaid	同步執行個體的付費類型，傳回值： PrePaid：訂用帳戶（預付費）。 PostPaid：隨用隨付（後付費）。
Performance	Struct		同步鏈路概況資訊。
FLOW	String	1	每秒同步資料的流量，單位為MB/s。
RPS	String	100	每秒同步SQL語句的次數，包括BEGIN、COMMIT 、DML語句（INSERT、DELETE、UPDATE）及DDL語句。
PrecheckStatus	Struct		預檢查狀態。
Detail	Array of CheckItem		各預檢查項的執行情況。
CheckStatus	String	Success	檢查結果，傳回值： Success：通過該項檢查。 Failed：未通過該項檢查。
ErrorMessage	String	Original error: Access denied for user 'dtstest'@'100.104.*.' (using password: YES)	預檢查未通過的錯誤提示。說明當CheckStatus參數傳回值為Failed時，才會返回本參數。
ItemName	String	CHECK_CONN_SRC	預檢查專案。
RepairMethod	String	CHECK_ERROR_DEST_CONN_REPAIR2	預檢查未通過時對應的修複方法。說明當CheckStatus參數傳回值為Failed時，才會返回本參數。
Percent	String	100	預檢查整體進度，單位為百分比。
Status	String	Success	預檢查結果，傳回值： Success：通過該項檢查。 Failed：未通過該項檢查。
RequestId	String	DACDF659-AFC6-4DC8-ADB8-4569419A4****	請求ID。
SourceEndpoint	Struct		源執行個體串連資訊。
EngineName	String	MySQL	源執行個體的資料庫類型。
IP	String	172.16.88.***	源執行個體的串連地址。
InstanceId	String	rm-bp1i99e8l7913****	源執行個體ID。
InstanceType	String	RDS	源執行個體類型。
Port	String	3306	源執行個體的資料庫服務連接埠。
UserName	String	dtstest	源執行個體的資料庫帳號。
Status	String	synchronizing	同步執行個體的狀態，傳回值： notStarted：未啟動。 prechecking：預檢查中。 precheckFailed：預檢查失敗。 initializating：同步初始化中。 initializeFailed：同步初始化失敗。 synchronizing：同步中。 failed：同步失敗。 suspending：暫停。 modifying：同步對象變更中。 finished：完成。
StructureInitialization	String	true	是否執行結構初始化，傳回值： true：是 false：否
StructureInitializationStatus	Struct		結構初始化狀態。
ErrorMessage	String	DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist;	結構初始化出現異常的錯誤提示。
Percent	String	100	結構初始化進度，單位為百分比。
Progress	String	1	已完成結構初始化的表的數量。
Status	String	Finished	結構初始化狀態，取值包括： NotStarted：未啟動。 Migrating：初始化中。 Failed：初始化失敗。 Finished：初始化完成。
Success	String	true	請求是否成功。
SynchronizationDirection	String	Forward	同步方向，傳回值： Forward：正向。 Reverse：反向。
SynchronizationJobClass	String	large	同步鏈路規格。
SynchronizationJobName	String	MySQL同步	同步執行個體名稱。
SynchronizationJobId	String	dtsexjk1alb116****	資料同步執行個體ID。
SynchronizationObjects	Array of SynchronizationObject		同步對象。
NewSchemaName	String	newdtstestdatabase	待同步的庫在目標資料庫中映射的名稱。
SchemaName	String	dtstestdatabase	待同步的庫名。
TableExcludes	Array of TableExclude		待同步庫中排除的表，這些表將不會被同步。
TableName	String	order	排除的表的名稱。
TableIncludes	Array of TableInclude		待同步的表。
TableName	String	customer	待同步表名。
TaskId	String	exjk1alb116****	資料同步任務ID，可用於配置控制台任務詳情頁面的連結。說明同步任務詳情頁的連結為：https://dts.console.alibabacloud.com/#/syncmore/exjk1alb116/config/ 。

樣本

請求樣本

http(s)://dts.aliyuncs.com/?Action=DescribeSynchronizationJobStatus
&SynchronizationJobId=dtsexjk1alb116****
&<公用請求參數>

正常返回樣本

XML格式

<DescribeSynchronizationJobStatusResponse>
      <TaskId>exjk1alb116****</TaskId>
      <SynchronizationObjects>
            <SchemaName>newdtstestdatabase</SchemaName>
            <NewSchemaName>dtstestdatabase</NewSchemaName>
      </SynchronizationObjects>
      <DataInitializationStatus>
            <Status>Finished</Status>
            <Progress>200001</Progress>
            <Percent>100</Percent>
      </DataInitializationStatus>
      <Delay>0</Delay>
      <Success>true</Success>
      <DelayMillis>0</DelayMillis>
      <DataInitialization>true</DataInitialization>
      <SynchronizationJobClass>large</SynchronizationJobClass>
      <Status>synchronizing</Status>
      <RequestId>DACDF659-AFC6-4DC8-ADB8-4569419A****</RequestId>
      <SynchronizationJobName>MySQL同步</SynchronizationJobName>
      <PayType>PostPaid</PayType>
      <ErrMessage></ErrMessage>
      <PrecheckStatus>
            <Status>Finished</Status>
            <Percent>100</Percent>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_CONN_SRC</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_AUTH_SRC</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_CONN_DEST</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_AUTH_DEST</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_BINLOG_ON</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_BINLOG_MODE</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_BINLOG_ROW_IMAGE</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_SERVER_ID</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_BINLOG_EXIST</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_ENGINE</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_MYSQL_PASSOWRD_FORMAT</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_SRC</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_SAME_OBJ</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_SQL_MODE</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_SAME_USER</ItemName>
            </Detail>
            <Detail>
                  <CheckStatus>Success</CheckStatus>
                  <ItemName>CHECK_TOPOLOGY</ItemName>
            </Detail>
      </PrecheckStatus>
      <Checkpoint>1610616144</Checkpoint>
      <SynchronizationJobId>dtsexjk1alb116****</SynchronizationJobId>
      <DestinationEndpoint>
            <InstanceId>rm-bp1u40w1ip917****</InstanceId>
            <InstanceType>RDS</InstanceType>
            <EngineName>MySQL</EngineName>
      </DestinationEndpoint>
      <SourceEndpoint>
            <InstanceId>rm-bp1i99e8l7913****</InstanceId>
            <InstanceType>RDS</InstanceType>
            <EngineName>MySQL</EngineName>
      </SourceEndpoint>
      <StructureInitialization>true</StructureInitialization>
      <Performance>
            <RPS>0</RPS>
            <FLOW>0.00MB/s</FLOW>
      </Performance>
      <StructureInitializationStatus>
            <Status>Finished</Status>
            <Progress>1</Progress>
            <Percent>100</Percent>
      </StructureInitializationStatus>
</DescribeSynchronizationJobStatusResponse>

JSON格式

{
	"TaskId": "exjk1alb116****",
    "SynchronizationObjects": [
		{
			"TableIncludes": [],
			"TableExcludes": [],
			"SchemaName": "newdtstestdatabase",
			"NewSchemaName": "dtstestdatabase"
		}
	],
	"DataInitializationStatus": {
		"Status": "Finished",
		"Progress": "200001",
		"Percent": "100"
	},
	"Delay": "0",
	"Success": true,
	"DelayMillis": 0,
	"DataInitialization": true,
	"SynchronizationJobClass": "large",
	"Status": "synchronizing",
	"RequestId": "DACDF659-AFC6-4DC8-ADB8-4569419A****",
	"SynchronizationJobName": "MySQL同步",
	"PayType": "PostPaid",
	"ErrMessage": "",
	"PrecheckStatus": {
		"Status": "Finished",
		"Percent": "100",
		"Detail": [
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_CONN_SRC"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_AUTH_SRC"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_CONN_DEST"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_AUTH_DEST"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_BINLOG_ON"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_BINLOG_MODE"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_BINLOG_ROW_IMAGE"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_SERVER_ID"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_BINLOG_EXIST"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_ENGINE"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_MYSQL_PASSOWRD_FORMAT"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_SRC"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_SAME_OBJ"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_SQL_MODE"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_SAME_USER"
			},
			{
				"CheckStatus": "Success",
				"ItemName": "CHECK_TOPOLOGY"
			}
		]
	},
	"Checkpoint": "1610616144",
	"SynchronizationJobId": "dtsexjk1alb116****",
	"DestinationEndpoint": {
		"InstanceId": "rm-bp1u40w1ip917****",
		"InstanceType": "RDS",
		"EngineName": "MySQL"
	},
	"SourceEndpoint": {
		"InstanceId": "rm-bp1i99e8l7913****",
		"InstanceType": "RDS",
		"EngineName": "MySQL"
	},
	"StructureInitialization": true,
	"Performance": {
		"RPS": "0",
		"FLOW": "0.00MB/s"
	},
	"StructureInitializationStatus": {
		"Status": "Finished",
		"Progress": "1",
		"Percent": "100"
	}
}

錯誤碼

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