Geçiş, senkronizasyon ve abonelik nesnelerini yapılandırmak veya sorgulamak için DTS API işlemlerini çağırın. Bu konu, nesne tanımlarını, parametreleri ve yapılandırma örneklerini kapsar.
İlgili API işlemleri ve parametreler
|
API |
Açıklama |
|
|
|
|
|
Geçiş, senkronizasyon veya abonelik nesnelerinin tanımı
Nesneyle ilgili parametreler JSON dizeleri kullanır. Aşağıdaki bölümde kullanılabilir parametreler açıklanmaktadır.
-
Nesneler birden çok veritabanı içerdiğinde:
ÖnemliAbonelik örnekleri eşlemeyi desteklemez.
nameparametre değeri, gerçek veritabanı veya tablo adıyla eşleşmelidir.{ "Name of database 1 to be migrated, synchronized, or subscribed to": { "name": "Name of database 1 in the destination instance", "all": true (Indicates that the entire database is migrated, synchronized, or subscribed to) }, "Name of database 2 to be migrated, synchronized, or subscribed to": { "name": "Name of database 2 in the destination instance", "all": false (Indicates that the entire database is not migrated, synchronized, or subscribed to), "Table": { "Name of table A to be migrated, synchronized, or subscribed to": { "name": "Name of table A in the destination instance", "all": true (Indicates that the entire table is migrated, synchronized, or subscribed to), "dml_op": "DML operations to be incrementally migrated or synchronized", "ddl_op": "DDL operations to be incrementally migrated or synchronized" } } }, "Name of database 3 to be migrated, synchronized, or subscribed to": { "name": "Name of database 3 in the destination instance", "all": true (Indicates that the entire database is migrated, synchronized, or subscribed to), "dml_op": "DML operations to be incrementally migrated or synchronized", "ddl_op": "DDL operations to be incrementally migrated or synchronized" } } -
Nesneler sütun düzeyindeyse veya filtre koşulları içeriyorsa:
{ "Name of database to be migrated, synchronized, or subscribed to": { "name": "Name of database in the destination instance", "all": false (Indicates that the entire database is not migrated, synchronized, or subscribed to), "Table": { "Name of table A to be migrated, synchronized, or subscribed to": { "name": "Name of table A in the destination instance", "all": false (Indicates that the entire table is not migrated, synchronized, or subscribed to), "filter": "id>10" "column": { "id": { "key": "PRI", "name": "id", "type": "int(11)", "sharedKey": false, "state": "checked" } }, "shard": 12 } } } } -
Hedef AnalyticDB for MySQL veya AnalyticDB for PostgreSQL olduğunda:
{ "Name of database to be migrated or synchronized": { "name": "Name of database in the destination instance", "all": false (Fixed as false. Regardless of whether the objects are at the database or table level, if the destination instance is AnalyticDB for MySQL or AnalyticDB for PostgreSQL, this parameter is fixed as false, and you must also specify information such as the partition key of the table), "Table": { "Name of table A to be migrated or synchronized": { "all": true (Indicates that the entire table is migrated or synchronized), "name": "Name of table A in the destination instance", "primary_key": "id (Specifies the primary key)", "type": "dimension (Type of the table)", } "Name of table B to be migrated or synchronized": { "all": true (Indicates that the entire table is migrated or synchronized), "name": "Name of table B in the destination instance", "part_key": "id (Specifies the partition key)", "primary_key": "id (Specifies the primary key)", "type": "partition (Type of the table)", "tagColumnValue": "Value of the tag column" } } } } -
Senkronizasyon nesneleri için bağımsız çakışma çözümleme ilkeleri ayarladığınızda:
NotBu özellik yalnızca MySQL örnekleri arasında veya PolarDB for MySQL kümeleri arasındaki çift yönlü senkronizasyon örnekleri için desteklenir.
Veritabanı veya tablo düzeyinde bağımsız çakışma çözümleme ilkeleri ayarlayabilirsiniz.
Bağımsız bir çakışma çözümleme ilkesi yapılandırılmış sütunlar için genel çakışma çözümleme ilkesi etkili olmaz.
Tablo düzeyi ayarları
{ "Name of database 1 to be synchronized": { "name": "Name of database 1 in the destination instance", "all": true (Indicates that the entire database is synchronized), "conflict": "Task-level conflict resolution policy" }, "Name of database 2 to be synchronized": { "name": "Name of database 2 in the destination instance", "all": false (Indicates that the entire database is not synchronized), "conflict": "overwrite", "Table": { "Name of table A to be synchronized": { "name": "Name of table A in the destination instance", "all": true (Indicates that the entire table is synchronized), "cdr_cmp_col": "Conflict detection column", "cdr_rslv_col": "Conflict detection column", "resolve_method": "Table-level conflict resolution policy" } } } }Veritabanı düzeyi ayarları
-
Senkronizasyon nesnesi tüm bir veritabanı olduğunda:
"Name of database 1 to be synchronized": { "name": "Name of database 1 in the destination instance", "all": true (Indicates that the entire database is synchronized), "conflict": "Task-level conflict resolution policy", "cdr_cmp_col": "Conflict detection column", "cdr_rslv_col": "Conflict detection column", "resolve_method": "Database-level conflict resolution policy" } } -
Senkronizasyon nesnesi tüm bir veritabanı olmadığında:
"Name of database 2 to be synchronized": { "name": "Name of database 2 in the destination instance", "all": false (Indicates that the entire database is not synchronized), "conflict": "Task-level conflict resolution policy", "cdr_cmp_col": "Conflict detection column", "cdr_rslv_col": "Conflict detection column", "resolve_method": "Database-level conflict resolution policy", "Table": { "Name of table A to be synchronized": { "name": "Name of table A in the destination instance", "all": true (Indicates that the entire table is synchronized) } } }
-
Bir veri gölüne veri entegrasyon görevi yapılandırdığınızda:
Parametre
Açıklama
write_operationVeri çakışması oluştuğunda kullanılan yazma yöntemi.
-
append: Mevcut verileri korur ve yeni veriler ekler. -
overwrite: Hedefteki çakışan verilerin üzerine yazar. -
errorIfExists: Görev bir hata bildirir ve çıkar. -
ignore: Geçerli yazma işlemini atlar ve hedefteki mevcut verileri korur.
targetTypeOSS'e yazıldıktan sonraki veri biçimi (zorunlu dönüştürme). Desteklenen biçimler:
Byte,Integer,Long,Double,String,Binary,Boolean,TimestampveDate.NotBelirtilmezse DTS, kaynak veri türlerini otomatik olarak dönüştürür.
etl_dateEklenecek ek sütunun (sabit) adı.
Notİki
etl_dateparametresinin değerleri aynı olmalıdır.syntacticTypeADD olarak sabitlenmiştir; bu, bir sütun eklendiğini gösterir.
NotEklenen sütun değeri (
value), tek tırnak içine alınmış ('') bir sabit olmalıdır.part_keyHedef tablonun bölüm anahtarı. İki olası değer:
NotYalnızca hedef tablo bölümlendirilmiş olduğunda gereklidir.
-
Kaynaktan entegre edilecek bir sütun.
-
Hedefe eklenen ve bölüm anahtarı olarak ayarlanan bir sabit sütun.
NotBiçim
<Key>=<Value>şeklindedir. Örneğin,dt=2025-07-07, değeri2025-07-07olandtadlı bir sabit sütunu belirtir.
{ "Name of database 1 to be integrated": { "all": false (Fixed as false), "Table": { "Name of table A to be integrated": { "all": false (Indicates that the entire table is not integrated), "filter": "", "write_operation": "Method used to write data", "name": "Name of table A in the destination instance", "column": { "Name of column a to be integrated": { "name": "Name of column a in the destination instance", "targetType": "Type of the column in OSS" }, ******, "etl_date": { "syntacticType": "ADD (Fixed as ADD)", "name": "etl_date", "type": "String (Fixed as String)", "value": "'2025-07-08 03:30:00'" } }, "part_key": "dt=2025-07-07" } }, "name": "dtstestdata (Name of database 1 in the destination instance)" } } -
|
Parametre |
Açıklama |
|
|
Kaynak veritabanının, tablosunun veya sütununun hedefteki eşlenen adı. Örneğin, dtssource veritabanını dtstarget'a geçirmek için bu parametreyi dtstarget olarak ayarlayın. |
|
|
Tüm tabloların veya sütunların seçilip seçilmeyeceğini belirtir. Geçerli değerler:
|
|
|
Kaynak tablo bilgileri. |
|
|
Geçiş, senkronizasyon veya abonelik yapılacak veriler için filtre koşulu. Yalnızca tablo düzeyinde ayarlanabilir. Örneğin, bu parametreyi Not
Abonelik görevleri filtre koşullarının ayarlanmasını desteklemez. |
|
|
Kaynak sütun bilgileri. |
|
|
Sütunun birincil anahtar olup olmadığını belirtir. Geçerli değerler:
|
|
|
Sütunun parça anahtarı olup olmadığını belirtir. Geçerli değerler:
Not
Yalnızca veritabanı türü Kafka olduğunda gereklidir. |
|
|
Alanın veri türü. |
|
|
Değer |
|
|
Geçiş veya senkronizasyon yapılacak tablo için parça sayısı. Not
Yalnızca veritabanı türü Kafka olduğunda gereklidir. |
|
|
Artımlı olarak geçiş veya senkronizasyon yapılacak DML işlemleri. Geçerli değerler:
Not
Görev türüne göre desteklenen DML işlemleri için Geçiş çözümleri veya Senkronizasyon çözümleri içindeki yapılandırma belgelerini kontrol edin. |
|
|
Artımlı olarak geçiş veya senkronizasyon yapılacak DDL işlemleri. Geçerli değerler:
Not
Görev türüne göre desteklenen DDL işlemleri için Geçiş çözümleri veya Senkronizasyon çözümleri içindeki yapılandırma belgelerini kontrol edin. |
|
|
Birincil anahtar. Yalnızca hedef AnalyticDB for MySQL veya AnalyticDB for PostgreSQL olduğunda gereklidir. |
|
|
Bölüm anahtarı. Hedef AnalyticDB for MySQL veya AnalyticDB for PostgreSQL olduğunda gereklidir. |
|
Önemli
Bu |
Hedef AnalyticDB for MySQL veya AnalyticDB for PostgreSQL olduğunda tablo türü. Geçerli değerler:
|
|
|
__dts_data_source etiket sütununun özel değeri. Hedef AnalyticDB for MySQL olduğunda gereklidir. |
|
|
Görev düzeyindeki genel çakışma çözümleme ilkesi. Aynı değere sahip olacak şekilde senkronize edilecek her veritabanına dahil edilmelidir. Geçerli değerler:
|
|
|
Tablo düzeyindeki bağımsız çakışma çözümleme ilkesi. Yalnızca artımlı senkronizasyon için desteklenir. Geçerli değerler:
|
|
|
|
|
|
Yapılandırma örnekleri
-
Örnek 1: dtstestdata veritabanındaki tüm tabloları geçirin, senkronize edin veya abone olun.
{"dtstestdata": { "name": "dtstestdata", "all": true }} -
Örnek 2: dtstestdata veritabanını geçirin veya senkronize edin ve adını dtstestdata_new olarak değiştirin.
{"dtstestdata": { "name": "dtstestdata_new", "all": true }} -
Örnek 3: dtstestdata veritabanındaki belirli tabloları (örneğin customer) geçirin, senkronize edin veya abone olun.
{"dtstestdata": { "name": "dtstestdata", "all": false, "Table": { "customer": { "name": "customer", "all": true, "column": { "id": { "key": "PRI", "name": "id", "type": "int(11)", "sharedKey": false, "state": "checked" }, "gmt_create": { "key": "", "name": "gmt_create", "type": "datetime", "sharedKey": false, "state": "checked" }, "gmt_modify": { "key": "", "name": "gmt_modify", "type": "datetime", "sharedKey": false, "state": "checked" }, "valid_time": { "key": "", "name": "valid_time", "type": "datetime", "sharedKey": false, "state": "checked" }, "creator": { "key": "", "name": "creator", "type": "varchar(200)", "sharedKey": false, "state": "checked" } }, "shard": 12 } } } } -
Örnek 4: dtstestdata veritabanındaki tabloların (örneğin customer ve order) belirli sütunlarını geçirin veya senkronize edin.
{"dtstestdata": { "name": "dtstestdata", "all": false, "Table": { "customer": { "name": "customer", "all": false, "column": { "id": { "key": "PRI", "name": "id", "type": "int(11)", "sharedKey": false, "state": "checked" }, "level": { "key": "", "name": "level", "type": "varchar(5000)", "sharedKey": false, "state": "checked" }, "name": { "key": "", "name": "name", "type": "varchar(500)", "sharedKey": false, "state": "checked" }, }, "shard": 12 }, "order": { "name": "order", "all": false, "column": { "id": { "key": "PRI", "name": "id", "type": "int(11)", "sharedKey": false, "state": "checked" } }, "shard": 12 } } } } -
Örnek 5: dtstestdata veritabanındaki tabloları (örneğin customer, order ve commodity) bir hedef AnalyticDB for MySQL veya AnalyticDB for PostgreSQL örneğine geçirin veya senkronize edin.
{ "dtstestdata": { "name": "dtstestdatanew", "all": false, "Table": { "order": { "name": "ordernew", "all": true, "part_key": "id", "primary_key": "id", "type": "partition" }, "customer": { "name": "customernew", "all": true, "primary_key": "id", "type": "dimension" }, "commodity": { "name": "commoditynew", "all": false, "filter": "id>10", "column": { "id": { "key": "PRI", "name": "id", "type": "int(11)" } }, "part_key": "id", "primary_key": "id", "type": "partition" } } } } -
Örnek 6: Senkronizasyon nesneleri için bağımsız çakışma çözümleme ilkeleri ayarlayın.
Tablo düzeyi ayarları
Senkronizasyon görevi nesneleri için genel çakışma çözümleme ilkesini
interruptolarak ayarlayın. dtstestdata2 veritabanındaki customer tablosunun birincil anahtar sütunları, benzersiz anahtar sütunları venamesütunu için bağımsız çakışma çözümleme ilkesinioverwriteolarak ayarlayın.{ "dtstestdata1": { "name": "dtstestdata1", "all": true, "conflict": "interrupt" }, "dtstestdata2": { "name": "dtstestdata2", "all": false, "conflict": "interrupt", "Table": { "customer": { "name": "customer", "all": true, "cdr_cmp_col": "name", "cdr_rslv_col": "name", "resolve_method": "overwrite" } } } }Veritabanı düzeyi ayarları
-
Senkronizasyon nesnesi tüm bir veritabanı olduğunda: dtstestdata1 veritabanında senkronize edilecek tüm tabloların
nameveaddrsütunları için bağımsız çakışma çözümleme ilkesiniuse_maxolarak ayarlayın."dtstestdata1": { "name": "dtstestdata1", "all": true, "conflict": "overwrite", "cdr_cmp_col": "name,addr", "cdr_rslv_col": "name,addr", "resolve_method": "use_max" } } -
Senkronizasyon nesnesi tüm bir veritabanı olmadığında: dtstestdata2 veritabanında senkronize edilecek tüm tabloların
nameveaddrsütunları için bağımsız çakışma çözümleme ilkesiniuse_maxolarak ayarlayın."dtstestdata2": { "name": "dtstestdata2", "all": false, "conflict": "overwrite", "cdr_cmp_col": "name,addr", "cdr_rslv_col": "name,addr", "resolve_method": "use_max", "Table": { "person": { "name": "person", "all": true }, "class": { "name": "class", "all": true } } }
-
-
Örnek 7: Kaynak veritabanı türü Tair/Redis olan bir senkronizasyon örneği için, 0 ve 1 numaralı DB'lerden yalnızca
HPropanahtar önekine sahip verileri senkronize edin (yani Prefixes of Keys to Be Synchronized değeriHPropolur). 2 numaralı DB için, yalnızcadtsanahtar önekine sahip ancakdtstestiçermeyen verileri senkronize edin (yani Prefixes of Keys to Be Synchronized değeridts, Prefixes of Keys to Be Filtered Out değeri isedtstestolur).{ "0": { "name": "0", "all": true, "filter": "[{"condition":"HProp","filterType":"white","filterPattern":"prefix"}]" }, "1": { "name": "1", "all": true, "filter": "[{"condition":"HProp","filterType":"white","filterPattern":"prefix"}]" }, "2": { "name": "2", "all": true, "filter": "[{"condition":"dts","filterType":"white","filterPattern":"prefix"},{"condition":"dtstest","filterType":"black","filterPattern":"prefix"}]" } } -
Örnek 8: dtstestdata veritabanındaki commodity tablosunu Delta biçiminde hedef OSS'e entegre edin.
{ "dtstestdata(": { "all": false, "Table": { "commodity": { "all": false(), "filter": "", "write_operation": "overwrite", "name": "commodity", "column": { "IS_VALID": { "name": "is_valid", "targetType": "String" }, "BuiltinArchiveDate": { "name": "builtinarchivedate", "targetType": "String" }, "PRODUCT_NAME": { "name": "product_name", "targetType": "String" }, "PRODUCT_CODE": { "name": "product_code", "targetType": "String" }, "etl_date": { "syntacticType": "ADD", "name": "etl_date", "type": "String", "value": "'2025-07-08 03:30:00'" } }, "part_key": "dt=2025-07-07" } }, "name": "dtstestdata" } }