Tüm Ürünler
Search
Belge Merkezi

Data Transmission Service:Veri senkronizasyon işinin durumunu sorgulama

Son Güncelleme:Oct 05, 2026

Bir veri senkronizasyon işinin durumunu sorgular.

Test

Bu işlemi OpenAPI Explorer'da çağırabilirsiniz. Başarılı bir çağrıdan sonra OpenAPI Explorer otomatik olarak SDK örnek kodu oluşturur.

İstek parametreleri

Ad

Tür

Gerekli

Örnek

Açıklama

Action String Evet DescribeSynchronizationJobStatus

Değeri DescribeSynchronizationJobStatus olarak ayarlayın.

RegionId String Hayır cn-hangzhou

Veri senkronizasyonu örneğinin bulunduğu bölgenin kimliği. Daha fazla bilgi için bkz. Desteklenen bölgeler.

SynchronizationJobId String Evet dtsexjk1alb116****

Veri senkronizasyonu işinin kimliği. İş kimliğini sorgulamak için DescribeSynchronizationJobs işlemini çağırabilirsiniz.

SynchronizationDirection String Hayır Forward

Senkronizasyon yönü. Geçerli değerler:

  • Forward: Veriler kaynak veritabanından hedef veritabanına senkronize edilir.
  • Reverse: Veriler hedef veritabanından kaynak veritabanına senkronize edilir.
Not Varsayılan değer Forward'dir.

Reverse değeri yalnızca veri senkronizasyonu işinin topolojisi iki yönlü senkronizasyon ise etkili olur.

ClientToken String Hayır 0c593ea1-3bea-11e9-b96b-88e9fe63****

İsteğin yinelenebilirliğini (idempotency) sağlayan istemci belirteci. Değer farklı istekler arasında benzersiz olmalı ve yalnızca ASCII karakterleri içerebilir. Maksimum uzunluk: 64 karakter.

AccountId String Hayır 12323344****

Alibaba Cloud hesap kimliği. Bu parametre kullanımdan kaldırılacağından ayarlamanıza gerek yoktur.

ResourceGroupId String Hayır rg-acfmzawhxxc****

Kaynak grubunun kimliği.

Yanıt parametreleri

Ad

Tür

Örnek

Açıklama

SynchronizationJobName String MySQL synchronization

Veri senkronizasyonu işinin adı.

Status String synchronizing

Veri senkronizasyonu işinin durumu. Geçerli değerler:

  • notStarted: İş başlatılmadı.
  • prechecking: İş ön denetim aşamasındadır.
  • precheckFailed: İş ön denetimi geçemedi.
  • initializating: İş ilk senkronizasyon aşamasındadır.
  • initializeFailed: İş ilk senkronizasyonda başarısız oldu.
  • synchronizing: İş senkronizasyon aşamasındadır.
  • failed: İş başarısız oldu.
  • suspending: İş duraklatıldı.
  • modifying: Senkronizasyon nesneleri değiştiriliyor.
  • finished: İş tamamlandı.
DataInitialization String true

İlk tam veri senkronizasyonunun yapılıp yapılmadığını belirtir.

  • true: Evet.
  • false: Hayır.
Delay String 0

Saniye cinsinden senkronizasyon gecikme süresi.

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].

Veri senkronizasyonu başarısız olursa döndürülen hata mesajı.

ExpireTime String 2021-03-07T16:00:00Z

Veri senkronizasyonu işinin sona erme zamanı. Zaman yyyy-MM-ddTHH:mm:ssZ biçimindedir. Zaman UTC olarak görüntülenir.

Not Bu parametre yalnızca PayType parametresinin dönüş değeri PrePaid ise döndürülür.
ErrCode String InternalError

Çağrı başarısız olursa döndürülen hata kodu.

Success String true

İsteğin başarılı olup olmadığını belirtir.

StructureInitialization String true

İlk şema senkronizasyonunun yapılıp yapılmadığını belirtir.

  • true: Evet.
  • false: Hayır.
PayType String PrePaid

Veri senkronizasyonu işinin faturalandırma yöntemi. Geçerli değerler:

  • PrePaid: abonelik.
  • PostPaid: kullandıkça öde.
ErrMessage String The request processing has failed due to some unknown error.

Çağrı başarısız olursa döndürülen hata mesajı.

SynchronizationJobClass String large

Veri senkronizasyonu işinin teknik özellikleri.

RequestId String DACDF659-AFC6-4DC8-ADB8-4569419A4****

İsteğin kimliği.

SynchronizationJobId String dtsexjk1alb116****

Veri senkronizasyonu işinin kimliği.

DelayMillis Long 506

Milisaniye cinsinden senkronizasyon gecikme süresi.

SynchronizationDirection String Forward

Senkronizasyon yönü. Geçerli değerler:

  • Forward: Veriler kaynak veritabanından hedef veritabanına senkronize edilir.
  • Reverse: Veriler hedef veritabanından kaynak veritabanına senkronize edilir.
TaskId String exjk1alb116****

Veri senkronizasyonu görevinin kimliği.

Checkpoint String 1610616144

UNIX zaman damgası olarak en son senkronize edilen veri kaydının zaman damgası.

Not UNIX zaman damgası dönüştürücüsü bulmak için bir arama motoru kullanabilirsiniz.
DataInitializationStatus Object

İlk tam veri senkronizasyonunun durumu.

Status String Finished

İlk tam veri senkronizasyonunun durumu. Geçerli değerler:

  • NotStarted: Senkronizasyon başlatılmadı.
  • Migrating: Senkronizasyon devam ediyor.
  • Failed: Senkronizasyon başarısız oldu.
  • Finished: Senkronizasyon tamamlandı.
Percent String 100

Yüzde olarak ilk tam veri senkronizasyonunun ilerleme durumu.

ErrorMessage String java.lang.NumberFormatException: For input string: ""

İlk tam veri senkronizasyonu başarısız olursa döndürülen hata mesajı.

Progress String 200001

İlk tam veri senkronizasyonu sırasında senkronize edilen kayıt sayısı.

DataSynchronizationStatus Object

Artımlı veri senkronizasyonunun durumu.

Status String Finished

Artımlı veri senkronizasyonunun durumu. Geçerli değerler:

  • NotStarted: Senkronizasyon başlatılmadı.
  • Migrating: Senkronizasyon devam ediyor.
  • Failed: Senkronizasyon başarısız oldu.
  • Finished: Senkronizasyon tamamlandı.
Delay String 0

Saniye cinsinden artımlı veri senkronizasyonunun gecikme süresi.

Percent String 100

Yüzde olarak artımlı veri senkronizasyonunun ilerleme durumu.

ErrorMessage String The task has failed for too long and cannot be recovered.

Artımlı veri senkronizasyonu başarısız olursa döndürülen hata mesajı.

DelayMillis Long 856

Milisaniye cinsinden artımlı veri senkronizasyonunun gecikme süresi.

Checkpoint String 1610709865

En son senkronize edilen veri kaydının zaman damgası. Bu bir UNIX zaman damgasıdır.

DestinationEndpoint Object

Hedef örneğin bağlantı ayarları.

InstanceId String rm-bp162d4tp0500****

Hedef örneğin kimliği.

IP String 172.16.88.***

Hedef örneğin uç noktası.

InstanceType String RDS

Hedef örneğin türü.

Port String 3306

Hedef veritabanının hizmet bağlantı noktası.

UserName String dtstest

Hedef örneğin veritabanı hesabı.

EngineName String MySQL

Hedef örneğin veritabanı türü.

Performance Object

Senkronizasyon bağlantısına genel bakış.

RPS String 100

BEGIN, COMMIT, DML ve DDL deyimleri dahil olmak üzere saniye başına senkronize edilen SQL deyimi sayısı.

FLOW String 1

MB/s cinsinden saniye başına senkronize edilen veri trafiği.

PrecheckStatus Object

Ön denetim durumu.

Status String Success

Ön denetim sonucu. Geçerli değerler:

  • Success: İş ön denetimi geçti.
  • Failed: İş ön denetimi geçemedi.
Percent String 100

Yüzde olarak genel ön denetim ilerleme durumu.

Detail Array of CheckItem

Her bir ön denetim öğesinin ayrıntıları.

CheckStatus String Success

Denetim sonucu. Geçerli değerler:

  • Success: Öğe denetimi geçti.
  • Failed: Öğe denetimi geçemedi.
ErrorMessage String Original error: Access denied for user 'dtstest'@'100.104.***.**' (using password: YES)

Ön denetim başarısız olursa döndürülen hata mesajı.

Not Bu parametre yalnızca CheckStatus parametresinin dönüş değeri Failed ise döndürülür.
ItemName String CHECK_CONN_SRC

Ön denetim öğesi.

RepairMethod String CHECK_ERROR_DEST_CONN_REPAIR2

Ön denetim hatasını düzeltme yöntemi.

Not Bu parametre yalnızca CheckStatus parametresinin dönüş değeri Failed ise döndürülür.
SourceEndpoint Object

Kaynak örneğin bağlantı ayarları.

InstanceId String rm-bp1i99e8l7913****

Kaynak örneğin kimliği.

IP String 172.16.88.***

Kaynak örneğin uç noktası.

InstanceType String RDS

Kaynak örneğin türü.

Port String 3306

Kaynak veritabanının hizmet bağlantı noktası.

UserName String dtstest

Kaynak örneğin veritabanı hesabı.

EngineName String MySQL

Kaynak örneğin veritabanı türü.

StructureInitializationStatus Object

İlk şema senkronizasyonunun durumu.

Status String Finished

İlk şema senkronizasyonunun durumu. Geçerli değerler:

  • NotStarted: Senkronizasyon başlatılmadı.
  • Migrating: Senkronizasyon devam ediyor.
  • Failed: Senkronizasyon başarısız oldu.
  • Finished: Senkronizasyon tamamlandı.
Percent String 100

Yüzde olarak ilk şema senkronizasyonunun ilerleme durumu.

ErrorMessage String DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist;

İlk şema senkronizasyonu sırasında bir özel durum oluşursa döndürülen hata mesajı.

Progress String 1

İlk şema senkronizasyonu sırasında şemaları senkronize edilen tablo sayısı.

SynchronizationObjects Array of SynchronizationObject

Senkronizasyon nesneleri.

NewSchemaName String newdtstestdatabase

Kaynak veritabanının hedefte eşlendiği veritabanının adı.

SchemaName String dtstestdatabase

Senkronize edilecek kaynak veritabanının adı.

TableExcludes Array of TableExclude

Veritabanında senkronizasyondan hariç tutulan tablolar.

TableName String order

Hariç tutulan tablonun adı.

TableIncludes Array of TableInclude

Senkronize edilecek tablolar.

TableName String customer

Senkronize edilecek tablonun adı.

Örnekler

Örnek istek

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

Örnek başarılı yanıt

XML biçimi

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 biçimi

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"
  }
}

Hata kodları


HTTP durum kodu


Hata kodu


Hata mesajı


Açıklama

400 Throttling.User Request was denied due to user flow control. İstek frekansı eşiğe ulaştığı için istek reddedildi. Daha sonra tekrar deneyin.
403 InvalidSecurityToken.Expired Specified SecurityToken is expired. Belirtilen güvenlik belirtecinin süresi doldu. İmzayı güncelleyin.
500 ServiceUnavailable The request has failed due to a temporary failure of the server. Sunucu zaman aşımına uğradığı veya kullanılamadığı için istek başarısız oldu. Tekrar deneyin. İstek tekrar başarısız olursa teknik destek ile iletişime geçin.

Hata kodlarının listesi için bkz. Hata Merkezi.