Tüm Ürünler
Search
Belge Merkezi

Data Transmission Service:Geçiş, senkronizasyon ve abonelik nesneleri

Son Güncelleme:Oct 05, 2026

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

Dblist istek parametresindeki nesneleri yapılandırın.

DbObject yanıt parametresindeki nesneleri sorgulayın.

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:

    Önemli

    Abonelik örnekleri eşlemeyi desteklemez. name parametre 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:

    Not
    • Bu ö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_operation

    Veri ç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.

    targetType

    OSS'e yazıldıktan sonraki veri biçimi (zorunlu dönüştürme). Desteklenen biçimler: Byte, Integer, Long, Double, String, Binary, Boolean, Timestamp ve Date.

    Not

    Belirtilmezse DTS, kaynak veri türlerini otomatik olarak dönüştürür.

    etl_date

    Eklenecek ek sütunun (sabit) adı.

    Not

    İki etl_date parametresinin değerleri aynı olmalıdır.

    syntacticType

    ADD olarak sabitlenmiştir; bu, bir sütun eklendiğini gösterir.

    Not

    Eklenen sütun değeri (value), tek tırnak içine alınmış ('') bir sabit olmalıdır.

    part_key

    Hedef tablonun bölüm anahtarı. İki olası değer:

    Not

    Yalnı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.

      Not

      Biçim <Key>=<Value> şeklindedir. Örneğin, dt=2025-07-07, değeri 2025-07-07 olan dt adlı 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

name

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.

all

Tüm tabloların veya sütunların seçilip seçilmeyeceğini belirtir. Geçerli değerler:

  • true: evet.

    Not

    True olarak ayarlanırsa, bireysel tabloları veya sütunları belirtmeniz gerekmez.

  • false: hayır.

Table

Kaynak tablo bilgileri.

filter

Geçiş, senkronizasyon veya abonelik yapılacak veriler için filtre koşulu. Yalnızca tablo düzeyinde ayarlanabilir.

Örneğin, bu parametreyi id>10 olarak ayarlayarak yalnızca ID sütun değeri 10'dan büyük olan verileri geçirebilir veya senkronize edebilirsiniz. Filtre koşullarının biçimi hakkında daha fazla bilgi için bkz. SQL koşuluyla görev verilerini filtreleme.

Not

Abonelik görevleri filtre koşullarının ayarlanmasını desteklemez.

column

Kaynak sütun bilgileri.

key

Sütunun birincil anahtar olup olmadığını belirtir. Geçerli değerler:

  • PRI: evet.

  • Boş dize: hayır.

sharedKey

Sütunun parça anahtarı olup olmadığını belirtir. Geçerli değerler:

  • true: evet.

  • false: hayır.

Not

Yalnızca veritabanı türü Kafka olduğunda gereklidir.

type

Alanın veri türü.

state

Değer checked ise sütun seçilir.

shard

Geçiş veya senkronizasyon yapılacak tablo için parça sayısı.

Not

Yalnızca veritabanı türü Kafka olduğunda gereklidir.

dml_op

Artımlı olarak geçiş veya senkronizasyon yapılacak DML işlemleri. Geçerli değerler:

  • i: INSERT.

  • u: UPDATE.

  • d: DELETE.

  • Bu parametre boşsa, görev tarafından desteklenen tüm DML işlemleri artımlı olarak geçiş veya senkronizasyon yapılır.

  • none: Hiçbir DML işlemi artımlı olarak geçiş veya senkronizasyon yapılmaz.

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.

ddl_op

Artımlı olarak geçiş veya senkronizasyon yapılacak DDL işlemleri. Geçerli değerler:

  • ct: CREATE TABLE.

  • at: ALTER TABLE.

  • dt: DROP TABLE.

  • rt: RENAME TABLE.

  • tt: TRUNCATE TABLE.

  • Bu parametre boşsa, görev tarafından desteklenen tüm DDL işlemleri artımlı olarak geçiş veya senkronizasyon yapılır.

  • none: Hiçbir DDL işlemi artımlı olarak geçiş veya senkronizasyon yapılmaz.

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.

primary_key

Birincil anahtar. Yalnızca hedef AnalyticDB for MySQL veya AnalyticDB for PostgreSQL olduğunda gereklidir.

part_key

Bölüm anahtarı. Hedef AnalyticDB for MySQL veya AnalyticDB for PostgreSQL olduğunda gereklidir.

type

Önemli

Bu type parametresi, bir alanın veri türünü temsil eden type parametresinden farklıdır.

Hedef AnalyticDB for MySQL veya AnalyticDB for PostgreSQL olduğunda tablo türü. Geçerli değerler:

  • dimension: boyut tablosu.

  • partition: bölümlendirilmiş tablo.

tagColumnValue

__dts_data_source etiket sütununun özel değeri. Hedef AnalyticDB for MySQL olduğunda gereklidir.

conflict

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:

  • overwrite: Hedef veritabanındaki çakışan kayıtların üzerine yazar.

  • interrupt: Bir hata bildirir ve çıkar. Görev başarısız duruma geçer ve manuel müdahale gerektirir.

    Not

    Konsolda TaskFailed görüntülenir.

  • ignore: Çakışan deyimi atlar ve hedef veritabanındaki mevcut kayıtları korur.

resolve_method

Tablo düzeyindeki bağımsız çakışma çözümleme ilkesi. Yalnızca artımlı senkronizasyon için desteklenir. Geçerli değerler:

  • overwrite: Hedef veritabanındaki çakışan kayıtların üzerine yazar.

  • interrupt: Bir hata bildirir ve çıkar. Görev başarısız duruma geçer ve manuel müdahale gerektirir.

    Not

    Konsolda TaskFailed görüntülenir.

  • ignore: Çakışan deyimi atlar ve hedef veritabanındaki mevcut kayıtları korur.

  • use_max: Çakışan kayıtları karşılaştırır ve daha büyük değere sahip olanı yazar. Hedef kayıt yoksa veya alan türü desteklenmiyorsa overwrite seçeneğine geri döner.

  • use_min: Çakışan kayıtları karşılaştırır ve daha küçük değere sahip olanı yazar. Hedef kayıt yoksa veya alan türü desteklenmiyorsa ignore seçeneğine geri döner.

cdr_cmp_col

  • Tablo düzeyi: Bağımsız bir çakışma çözümleme ilkesi ayarlanması gereken, birincil anahtarlar ve benzersiz anahtarlar hariç çakışma algılama sütunu. Değerler aynı olmalıdır.

    Önemli
    • Çakışma çözümleme ilkesi use_max veya use_min olduğunda, cdr_cmp_col ve cdr_rslv_col parametreleri belirtilmelidir.

    • Değer varsayılan olarak zaten birincil anahtarları ve benzersiz anahtarları içerir. İlgili sütunları manuel olarak belirtmeniz gerekmez.

  • Veritabanı düzeyi: Bağımsız bir çakışma çözümleme ilkesi ayarlanması gereken çakışma algılama sütunu. Değerler aynı olmalıdır.

    Önemli

    cdr_cmp_col ve cdr_rslv_col parametreleri belirtilmelidir.

cdr_rslv_col

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 interrupt olarak ayarlayın. dtstestdata2 veritabanındaki customer tablosunun birincil anahtar sütunları, benzersiz anahtar sütunları ve name sütunu için bağımsız çakışma çözümleme ilkesini overwrite olarak 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 name ve addr sütunları için bağımsız çakışma çözümleme ilkesini use_max olarak 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 name ve addr sütunları için bağımsız çakışma çözümleme ilkesini use_max olarak 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 HProp anahtar önekine sahip verileri senkronize edin (yani Prefixes of Keys to Be Synchronized değeri HProp olur). 2 numaralı DB için, yalnızca dts anahtar önekine sahip ancak dtstest içermeyen verileri senkronize edin (yani Prefixes of Keys to Be Synchronized değeri dts, Prefixes of Keys to Be Filtered Out değeri ise dtstest olur).

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