Kueri status pekerjaan sinkronisasi data - Data Transmission Service

Topik ini menjelaskan cara memanggil operasi DescribeSynchronizationJobStatus untuk mengkueri status pekerjaan sinkronisasi data.

Uji Coba

Anda dapat memanggil operasi ini di OpenAPI Explorer. Setelah pemanggilan berhasil, OpenAPI Explorer secara otomatis menghasilkan contoh kode SDK.

Parameter Permintaan

Name	Type	Required	Example	Description
Action	String	Yes	DescribeSynchronizationJobStatus	Parameter yang diperlukan. Tetapkan nilainya ke DescribeSynchronizationJobStatus.
RegionId	String	No	cn-hangzhou	ID wilayah tempat instans sinkronisasi data berada. Untuk informasi selengkapnya, lihat Wilayah yang didukung.
SynchronizationJobId	String	Yes	dtsexjk1alb116****	ID pekerjaan sinkronisasi data. Anda dapat memanggil operasi DescribeSynchronizationJobs untuk mengkueri ID pekerjaan tersebut.
SynchronizationDirection	String	No	Forward	Arah sinkronisasi. Nilai yang valid: Forward: Data disinkronkan dari database sumber ke database tujuan. Reverse: Data disinkronkan dari database tujuan ke database sumber. Catatan Nilai default-nya adalah Forward. Nilai Reverse hanya berlaku jika topologi pekerjaan sinkronisasi data adalah sinkronisasi dua arah.
ClientToken	String	No	0c593ea1-3bea-11e9-b96b-88e9fe63****	Token klien yang digunakan untuk memastikan idempotensi permintaan. Hasilkan nilai parameter dari klien Anda agar nilainya unik di antara permintaan yang berbeda. Parameter ClientToken hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.
AccountId	String	No	12323344****	ID Akun Alibaba Cloud. Anda tidak perlu menyetel parameter ini karena parameter ini akan ditinggalkan (deprecated).
ResourceGroupId	String	No	rg-acfmzawhxxc****	ID kelompok sumber daya.

Parameter Respons

Name	Type	Example	Description
SynchronizationJobName	String	MySQL synchronization	Nama pekerjaan sinkronisasi data.
Status	String	synchronizing	Status pekerjaan sinkronisasi data. Nilai yang valid: notStarted: Pekerjaan belum dimulai. prechecking: Pekerjaan sedang dalam Pemeriksaan Awal. precheckFailed: Pekerjaan gagal dalam Pemeriksaan Awal. initializating: Pekerjaan sedang dalam Sinkronisasi awal. initializeFailed: Pekerjaan gagal dalam Sinkronisasi awal. synchronizing: Pekerjaan sedang dalam sinkronisasi. failed: Pekerjaan gagal. suspending: Pekerjaan dijeda. modifying: Objek sinkronisasi sedang dimodifikasi. finished: Pekerjaan selesai.
DataInitialization	String	true	Menunjukkan apakah sinkronisasi data penuh awal dilakukan. Nilai yang valid: true: Ya. false: Tidak.
Delay	String	0	Latensi sinkronisasi dalam satuan detik.
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].	Pesan kesalahan yang dikembalikan jika sinkronisasi data gagal.
ExpireTime	String	2021-03-07T16:00:00Z	Waktu kedaluwarsa pekerjaan sinkronisasi data. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC. Catatan Parameter ini hanya dikembalikan jika nilai kembali parameter PayType adalah PrePaid.
ErrCode	String	InternalError	Kode kesalahan yang dikembalikan jika pemanggilan gagal.
Success	String	true	Menunjukkan apakah permintaan berhasil.
StructureInitialization	String	true	Menunjukkan apakah sinkronisasi skema awal dilakukan. Nilai yang valid: true: Ya. false: Tidak.
PayType	String	PrePaid	Metode penagihan pekerjaan sinkronisasi data. Nilai yang valid: PrePaid: subscription. PostPaid: pay-as-you-go.
ErrMessage	String	The request processing has failed due to some unknown error.	Pesan kesalahan yang dikembalikan jika pemanggilan gagal.
SynchronizationJobClass	String	large	Spesifikasi pekerjaan sinkronisasi data.
RequestId	String	DACDF659-AFC6-4DC8-ADB8-4569419A4****	ID permintaan.
SynchronizationJobId	String	dtsexjk1alb116****	ID pekerjaan sinkronisasi data.
DelayMillis	Long	506	Latensi sinkronisasi dalam satuan milidetik.
SynchronizationDirection	String	Forward	Arah sinkronisasi. Nilai yang valid: Forward: Data disinkronkan dari database sumber ke database tujuan. Reverse: Data disinkronkan dari database tujuan ke database sumber.
TaskId	String	exjk1alb116****	ID tugas sinkronisasi data.
Checkpoint	String	1610616144	Stempel waktu catatan data terbaru yang telah disinkronkan. Ini adalah Stempel waktu UNIX. Catatan Anda dapat menggunakan mesin pencari untuk menemukan konverter Stempel waktu UNIX.
DataInitializationStatus	Object		Status sinkronisasi data penuh awal.
Status	String	Finished	Status sinkronisasi data penuh awal. Nilai yang valid: NotStarted: Sinkronisasi belum dimulai. Migrating: Sinkronisasi sedang berlangsung. Failed: Sinkronisasi gagal. Finished: Sinkronisasi selesai.
Percent	String	100	Kemajuan sinkronisasi data penuh awal dalam persentase.
ErrorMessage	String	java.lang.NumberFormatException: For input string: ""	Pesan kesalahan yang dikembalikan jika sinkronisasi data penuh awal gagal.
Progress	String	200001	Jumlah catatan yang telah disinkronkan selama sinkronisasi data penuh awal.
DataSynchronizationStatus	Object		Status sinkronisasi data inkremental.
Status	String	Finished	Status sinkronisasi data inkremental. Nilai yang valid: NotStarted: Sinkronisasi belum dimulai. Migrating: Sinkronisasi sedang berlangsung. Failed: Sinkronisasi gagal. Finished: Sinkronisasi selesai.
Delay	String	0	Latensi sinkronisasi data inkremental dalam satuan detik.
Percent	String	100	Kemajuan sinkronisasi data inkremental dalam persentase.
ErrorMessage	String	The task has failed for too long and cannot be recovered.	Pesan kesalahan yang dikembalikan jika sinkronisasi data inkremental gagal.
DelayMillis	Long	856	Latensi sinkronisasi data inkremental dalam satuan milidetik.
Checkpoint	String	1610709865	Stempel waktu catatan data terbaru yang telah disinkronkan. Ini adalah Stempel waktu UNIX.
DestinationEndpoint	Object		Pengaturan koneksi instans tujuan.
InstanceId	String	rm-bp162d4tp0500****	ID instans tujuan.
IP	String	172.16.88.***	Titik akhir instans tujuan.
InstanceType	String	RDS	Jenis instans tujuan.
Port	String	3306	Port layanan database tujuan.
UserName	String	dtstest	Akun database instans tujuan.
EngineName	String	MySQL	Jenis database instans tujuan.
Performance	Object		Ikhtisar tautan sinkronisasi.
RPS	String	100	Jumlah pernyataan SQL yang disinkronkan per detik. Ini mencakup pernyataan BEGIN, COMMIT, Data Manipulation Language (DML), dan Data Definition Language (DDL).
FLOW	String	1	Trafik data yang disinkronkan per detik, dalam satuan MB/s.
PrecheckStatus	Object		Status Pemeriksaan Awal.
Status	String	Success	Hasil Pemeriksaan Awal. Nilai yang valid: Success: Pekerjaan lulus Pemeriksaan Awal. Failed: Pekerjaan gagal dalam Pemeriksaan Awal.
Percent	String	100	Kemajuan keseluruhan Pemeriksaan Awal dalam persentase.
Detail	Array of CheckItem		Detail setiap item Pemeriksaan Awal.
CheckStatus	String	Success	Hasil pemeriksaan. Nilai yang valid: Success: Item lulus pemeriksaan. Failed: Item gagal dalam pemeriksaan.
ErrorMessage	String	Original error: Access denied for user 'dtstest'@'100.104.*.' (using password: YES)	Pesan kesalahan yang dikembalikan jika Pemeriksaan Awal gagal. Catatan Parameter ini hanya dikembalikan jika nilai kembali parameter CheckStatus adalah Failed.
ItemName	String	CHECK_CONN_SRC	Item Pemeriksaan Awal.
RepairMethod	String	CHECK_ERROR_DEST_CONN_REPAIR2	Metode untuk memperbaiki kegagalan Pemeriksaan Awal. Catatan Parameter ini hanya dikembalikan jika nilai kembali parameter CheckStatus adalah Failed.
SourceEndpoint	Object		Pengaturan koneksi instans sumber.
InstanceId	String	rm-bp1i99e8l7913****	ID instans sumber.
IP	String	172.16.88.***	Titik akhir instans sumber.
InstanceType	String	RDS	Jenis instans sumber.
Port	String	3306	Port layanan database sumber.
UserName	String	dtstest	Akun database instans sumber.
EngineName	String	MySQL	Jenis database instans sumber.
StructureInitializationStatus	Object		Status sinkronisasi skema awal.
Status	String	Finished	Status sinkronisasi skema awal. Nilai yang valid: NotStarted: Sinkronisasi belum dimulai. Migrating: Sinkronisasi sedang berlangsung. Failed: Sinkronisasi gagal. Finished: Sinkronisasi selesai.
Percent	String	100	Kemajuan sinkronisasi skema awal dalam persentase.
ErrorMessage	String	DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist;	Pesan kesalahan yang dikembalikan jika terjadi pengecualian selama sinkronisasi skema awal.
Progress	String	1	Jumlah tabel yang skemanya telah disinkronkan.
SynchronizationObjects	Array of SynchronizationObject		Objek sinkronisasi.
NewSchemaName	String	newdtstestdatabase	Nama database yang akan disinkronkan yang dipetakan ke database tujuan.
SchemaName	String	dtstestdatabase	Nama database yang akan disinkronkan.
TableExcludes	Array of TableExclude		Tabel yang dikecualikan dari tugas sinkronisasi dalam database. Tabel-tabel ini tidak disinkronkan.
TableName	String	order	Nama tabel yang dikecualikan.
TableIncludes	Array of TableInclude		Tabel yang akan disinkronkan.
TableName	String	customer	Nama tabel yang akan disinkronkan.

Contoh

Permintaan Contoh

http(s)://dts.aliyuncs.com/?Action=DescribeSynchronizationJobStatus
&SynchronizationJobId=dtsexjk1alb116****
&<Common request parameters>

Respons Sukses Contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/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 synchronization</SynchronizationJobName>
    <PayType>PostPaid</PayType>
    <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 format

HTTP/1.1 200 OK
Content-Type:application/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 synchronization",
  "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"
  }
}

Kode Kesalahan

HTTP status code	Error code	Error message	Description
400	Throttling.User	Request was denied due to user flow control.	Permintaan ditolak karena frekuensi permintaan mencapai ambang batas. Coba lagi nanti.
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	Token keamanan yang ditentukan telah kedaluwarsa. Perbarui signature.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	Permintaan gagal karena server mengalami timeout atau tidak tersedia. Coba lagi. Jika permintaan tetap gagal, hubungi dukungan teknis.

Untuk daftar kode kesalahan, lihat Error Center.