Tüm Ürünler
Search
Belge Merkezi

Data Transmission Service:ConfigureSynchronizationJob

Son Güncelleme:Oct 05, 2026

Bir veri senkronizasyonu görevini yapılandırır.

Bu işlemi çağırmadan önce bir veri senkronizasyonu örneği oluşturmak için CreateSynchronizationJob işlemini çağırın.

Not
  • Yapılandırmadan sonra görev otomatik olarak başlar ve ön denetim gerçekleştirir. StartSynchronizationJob işlemini çağırmanıza gerek yoktur.

  • Görev, ön denetim hatası nedeniyle başlatılamazsa hatayı kontrol etmek ve sorunu çözmek için DescribeSynchronizationJobStatus işlemini çağırın. Ardından görevi yeniden başlatmak için StartSynchronizationJob işlemini çağırın.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Farklı SDK'lar için örnek kod oluşturmak üzere bu işlemi OpenAPI Explorer'da çağırın.

İstek parametreleri

Parametre Tür Gerekli Örnek Açıklama
Action String Evet ConfigureSynchronizationJob

Gerçekleştirilecek işlem. Bu değeri ConfigureSynchronizationJob olarak ayarlayın.

DataInitialization Boolean Evet true

İlk tam veri senkronizasyonunun yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: evet
  • false: hayır
Not Varsayılan değer: true.
StructureInitialization Boolean Evet true

İlk şema senkronizasyonunun yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: evet
  • false: hayır
Not Varsayılan değer: true.
SynchronizationJobId String Evet dtsz4ao1dor13d****

Veri senkronizasyonu örneği kimliği. Örnek kimliklerini sorgulamak için DescribeSynchronizationJobs işlemini çağırın.

SynchronizationObjects String Evet [{"DBName":"dtstestdata","TableIncludes":[{"TableName":"customer"}]}]

Senkronize edilecek nesneler. Değer, normal ifadeleri destekleyen bir JSON dizesidir. SynchronizationObjects.

RegionId String Hayır cn-hangzhou

Veri senkronizasyonu örneğinin bölge kimliği. Desteklenen bölgelerin listesi.

SynchronizationJobName String Hayır MySQL Synchronization

Veri senkronizasyonu görevinin adı.

Not Kolay tanımlama için açıklayıcı bir ad kullanın. Benzersiz bir ad gerekmez.
SynchronizationDirection String Hayır Forward

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

  • Forward
  • Reverse
Not
  • Varsayılan değer: Forward.
  • Değer Reverse yalnızca veri senkronizasyonu örneğinin topolojisi çift yönlü senkronizasyon ise geçerli olur.
SourceEndpoint.InstanceId String Hayır rm-bp1i99e8l7913****

Kaynak örneğin kimliği.

SourceEndpoint.InstanceType String Hayır RDS

Kaynak örneğin türü. Geçerli değerler:

  • RDS: ApsaraDB RDS örneği
  • Redis: ApsaraDB for Redis örneği
  • PolarDB: PolarDB for MySQL kümesi veya PolarDB O Edition kümesi
  • ECS: Elastic Compute Service (ECS) üzerinde barındırılan kendi yönetiminizdeki veritabanı
  • Express: Express Connect üzerinden bağlanan kendi yönetiminizdeki veritabanı
  • dg: Database Gateway üzerinden bağlanan kendi yönetiminizdeki veritabanı
  • cen: Cloud Enterprise Network (CEN) üzerinden bağlanan kendi yönetiminizdeki veritabanı
Not Varsayılan değer RDS şeklindedir.
SourceEndpoint.IP String Hayır 172.16.88.***

Kaynak veritabanının IP adresi.

Not Bu parametreyi yalnızca SourceEndpoint.InstanceType parametresi ECS, Express, dg veya cen olarak ayarlandığında belirtmeniz gerekir.
SourceEndpoint.Port String Hayır 3306

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

Not Bu parametreyi yalnızca SourceEndpoint.InstanceType parametresi ECS, Express, dg veya cen olarak ayarlandığında belirtmeniz gerekir.
SourceEndpoint.UserName String Hayır dtstestaccount

Kaynak veritabanının veritabanı hesabı.

Not
  • Bu parametreyi yalnızca SourceEndpoint.InstanceType parametresi ECS, Express, dg veya cen olarak ayarlandığında belirtmeniz gerekir.
  • Eğer SourceEndpoint.InstanceType parametresi Redis olarak ayarlanırsa veritabanı hesabını belirtmenize gerek yoktur.
  • Gerekli izinler senkronizasyon senaryosuna göre değişir. Veri senkronizasyonu senaryolarına genel bakış.
SourceEndpoint.Password String Hayır Test123456

Kaynak veritabanı hesabının parolası.

Not Bu parametreyi yalnızca SourceEndpoint.InstanceType parametresi ECS, Express, dg veya cen olarak ayarlandığında belirtmeniz gerekir.
DestinationEndpoint.InstanceId String Hayır rm-bp1r46452ai50****

Hedef örneğin kimliği.

Not Eğer DestinationEndpoint.InstanceType parametresi MaxCompute veya DataHub olarak ayarlanırsa MaxCompute projesinin veya DataHub projesinin adını belirtmeniz gerekir.

Hedef örnek bir AnalyticDB for MySQL kümesi ise AnalyticDB for MySQL kümesinin kimliğini belirtin.

DestinationEndpoint.InstanceType String Hayır RDS

Hedef örneğin türü. Geçerli değerler:

  • Redis: ApsaraDB for Redis örneği
  • RDS: ApsaraDB RDS örneği
  • PolarDB: PolarDB for MySQL kümesi veya PolarDB O Edition kümesi
  • ECS: ECS üzerinde barındırılan kendi yönetiminizdeki veritabanı
  • Express: Express Connect üzerinden bağlanan kendi yönetiminizdeki veritabanı
  • DataHub: DataHub projesi
  • MaxCompute: MaxCompute projesi
  • AnalyticDB: AnalyticDB for MySQL kümesi V3.0 veya V2.0
  • Greenplum: AnalyticDB for PostgreSQL örneği
Not Varsayılan değer RDS şeklindedir.
DestinationEndpoint.IP String Hayır 172.16.88.***

Hedef veritabanının IP adresi.

Not Bu parametreyi yalnızca DestinationEndpoint.InstanceType parametresi Express, dg veya cen olarak ayarlandığında belirtmeniz gerekir.
DestinationEndpoint.Port String Hayır 3306

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

Not Bu parametreyi yalnızca DestinationEndpoint.InstanceType parametresi ECS, Express, dg veya cen olarak ayarlandığında belirtmeniz gerekir.
DestinationEndpoint.UserName String Hayır dtstestaccount

Hedef veritabanının veritabanı hesabı.

Not
  • Gerekli izinler senkronizasyon senaryosuna göre değişir. Veri senkronizasyonu senaryolarına genel bakış.
  • Eğer DestinationEndpoint.InstanceType parametresi ECS, Express, dg veya cen olarak ayarlanırsa DestinationEndpoint.UserName parametresini belirtmeniz gerekir.
  • Eğer DestinationEndpoint.InstanceType parametresi RDS olarak ayarlanır ve veritabanı sürümü MySQL 5.5 veya MySQL 5.6 ise DestinationEndpoint.UserName ve DestinationEndpoint.Password parametrelerini belirtmenize gerek yoktur.
  • Eğer DestinationEndpoint.InstanceType parametresi Redis olarak ayarlanırsa DestinationEndpoint.UserName parametresini belirtmenize gerek yoktur.
DestinationEndpoint.Password String Hayır Test654321

Hedef veritabanı hesabının parolası.

Not
  • Eğer DestinationEndpoint.InstanceType parametresi ECS, Express, dg veya cen olarak ayarlanırsa DestinationEndpoint.Password parametresini belirtmeniz gerekir.
SourceEndpoint.OwnerID String Hayır 140692647406****

Kaynak RDS örneği sahibinin Alibaba Cloud hesap kimliği.

Not Hesaplar arası senkronizasyon için gereklidir. Ayrıca SourceEndpoint.Role parametresini de belirtin.
SourceEndpoint.Role String Hayır ram-for-dts

Kaynak örneğe sahip olan Alibaba Cloud hesabı için yapılandırılan RAM rolünün adı.

PartitionKey.ModifyTime_Year Boolean Hayır true

Artımlı veri tablosunun modifytime_year alanı tarafından tanımlanan bölümler içerip içermediğini belirtir. Geçerli değerler: true ve false.

Not Bu parametre yalnızca DestinationEndpoint.InstanceType parametresi MaxCompute olarak ayarlandığında kullanılabilir.
PartitionKey.ModifyTime_Month Boolean Hayır true

Artımlı veri tablosunun modifytime_month alanı tarafından tanımlanan bölümler içerip içermediğini belirtir. Geçerli değerler: true ve false.

Not Bu parametre yalnızca DestinationEndpoint.InstanceType parametresi MaxCompute olarak ayarlandığında kullanılabilir.
PartitionKey.ModifyTime_Day Boolean Hayır true

Artımlı veri tablosunun modifytime_day alanı tarafından tanımlanan bölümler içerip içermediğini belirtir. Geçerli değerler: true ve false.

Not Bu parametre yalnızca DestinationEndpoint.InstanceType parametresi MaxCompute olarak ayarlandığında kullanılabilir.
PartitionKey.ModifyTime_Hour Boolean Hayır true

Artımlı veri tablosunun modifytime_hour alanı tarafından tanımlanan bölümler içerip içermediğini belirtir. Geçerli değerler: true ve false.

Not Bu parametre yalnızca DestinationEndpoint.InstanceType parametresi MaxCompute olarak ayarlandığında kullanılabilir.
PartitionKey.ModifyTime_Minute Boolean Hayır true

Artımlı veri tablosunun modifytime_minute alanı tarafından tanımlanan bölümler içerip içermediğini belirtir. Geçerli değerler: true ve false.

Not Bu parametre yalnızca DestinationEndpoint.InstanceType parametresi MaxCompute olarak ayarlandığında kullanılabilir.
MigrationReserved String Hayır { "autoStartModulesAfterConfig": "none", "targetTableMode": 2 }

DTS ayrılmış parametresi. Ön denetimin otomatik olarak başlatılıp başlatılmayacağı gibi özel gereksinimler için kullanılan bir JSON dizesidir. MigrationReserved.

Not Ayrıca ApsaraDB for Redis Enterprise Edition örnekleri arasındaki veri senkronizasyonu için de kullanılır. ApsaraDB for Redis Enterprise Edition örnekleri arasında tek yönlü veya çift yönlü veri senkronizasyonunu yapılandırmak için OpenAPI Explorer'ı kullanma.
Checkpoint String Hayır 1610540493

Senkronizasyon kontrol noktası.

AccountId String Hayır 12323344****

Alibaba Cloud hesap kimliği. Kullanımdan kaldırılmıştır; gelecekteki bir sürümde kaldırılacaktır.

SourceEndpoint.DatabaseName String Hayır dtstestdata

Kaynak örnekteki senkronizasyon nesnesinin ait olduğu veritabanının adı.

DestinationEndpoint.DataBaseName String Hayır dtstestdata

Hedef örnekteki senkronizasyon nesnesinin ait olduğu veritabanının adı.

Yanıt parametreleri

Parametre Tür Örnek Açıklama
ErrCode String InternalError


İstek başarısız olursa döndürülen hata kodu.

ErrMessage String The request processing has failed due to some unknown error.


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

RequestId String 2690E467-7773-43BC-A009-370EE2E7****


İstek kimliği.

Success String true


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

Örnekler

Örnek istekler

http(s)://dts.aliyuncs.com/?Action=ConfigureSynchronizationJob
&DataInitialization=true
&StructureInitialization=true
&SynchronizationJobId=dtsz4ao1dor13d****
&SynchronizationObjects=[{"DBName":"dtstestdata","TableIncludes":[{"TableName":"customer"}]}]
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

<ConfigureSynchronizationJobResponse>
      <RequestId>2690E467-7773-43BC-A009-370EE2E7****</RequestId>
      <Success>true</Success>
</ConfigureSynchronizationJobResponse>

JSON biçimi

{
    "RequestId": "2690E467-7773-43BC-A009-370EE2E7****",
    "Success": true
}

Hata kodları

Hata kodlarının listesi için API Hata Merkezi sayfasını ziyaret edin.