All Products
Search
Document Center

Data Transmission Service:Deskripsi parameter Reserve

Last Updated:Dec 11, 2025

Saat memanggil operasi API tertentu untuk mengonfigurasi atau mengkueri tugas migrasi, sinkronisasi, atau pelacakan, Anda perlu mengonfigurasi atau mengkueri parameter Reserve. Parameter ini berupa string dalam format JSON yang digunakan untuk melengkapi atau melihat informasi konfigurasi instans sumber atau tujuan, seperti format penyimpanan data kluster Kafka tujuan atau ID instans Cloud Enterprise Network (CEN). Topik ini menjelaskan skenario dan petunjuk konfigurasi untuk parameter Reserve.

Catatan

  • Konfigurasikan parameter umum berdasarkan tipe tugas instans dan jenis koneksi database, lalu sesuaikan parameter tambahan berdasarkan tipe database sumber dan tujuan.

  • Jika database sumber dan tujuan memiliki parameter yang sama, cukup konfigurasikan sekali saja.

  • Nilai numerik harus dibungkus dengan tanda kutip ganda ("") agar dikonversi menjadi string.

  • Anda dapat mengonfigurasi tugas di Konsol lalu melihat pratinjau parameter OpenAPI yang sesuai untuk membantu menentukan parameter permintaan. Untuk informasi selengkapnya, lihat Pratinjau parameter permintaan OpenAPI.

API Terkait

Parameter umum

Konfigurasikan parameter dalam parameter Reserve berdasarkan tipe instans DTS dan jenis koneksi database.

Tabel 1. Instans migrasi atau sinkronisasi

Parameter

Wajib

Deskripsi

targetTableMode

Ya

Mode pemrosesan untuk tabel yang sudah ada di database tujuan:

  • 0: Menjalankan pemeriksaan awal dan melaporkan kesalahan untuk menghentikan tugas.

  • 2: Mengabaikan error dan melanjutkan tugas.

dts.datamove.source.bps.max

Tidak

Jumlah maksimum data yang dapat disinkronkan atau dimigrasikan per detik untuk tugas penuh atau inkremental, dalam byte (B).

Catatan

Parameter ini harus digunakan bersama dengan fullDynamicConfig atau incDynamicConfig. Misalnya, saat memanggil API, teruskan {"fullDynamicConfig": {"dts.datamove.source.bps.max":10485760},"incDynamicConfig": {"dts.datamove.source.bps.max":10485760}}.

conflict

Tidak

Kebijakan resolusi konflik global untuk tugas sinkronisasi dua arah. Nilai yang valid:

  • overwrite: Jika terjadi konflik data selama sinkronisasi, catatan yang bertentangan di database tujuan akan ditimpa.

  • interrupt: Jika terjadi konflik data selama sinkronisasi, tugas sinkronisasi melaporkan error dan keluar. Tugas masuk ke status Gagal. Anda harus memperbaiki tugas secara manual.

  • ignore: Jika terjadi konflik data selama sinkronisasi, pernyataan sinkronisasi saat ini dilewati dan tugas dilanjutkan. Catatan yang bertentangan di database tujuan digunakan.

filterDDL

Tidak

Menentukan apakah akan memfilter operasi DDL untuk tugas maju dalam sinkronisasi dua arah. Nilai yang valid:

  • true: Tidak menyinkronkan operasi DDL.

  • false: Menyinkronkan operasi DDL.

    Penting

    Tugas balik secara otomatis memfilter operasi DDL.

autoStartModulesAfterConfig

Tidak

Parameter kontrol startup tugas. Nilai yang valid:

  • none: Setelah tugas DTS dikonfigurasi, modul seperti Pemeriksaan Awal tidak dijalankan. Anda harus menjalankan tugas secara manual.

  • auto: Setelah tugas DTS dikonfigurasi, modul Pemeriksaan Awal dan semua modul berikutnya dijalankan secara otomatis.

    Catatan

    Nilai default adalah auto untuk skenario beli-dulu. Parameter ini tidak berlaku untuk skenario konfigurasi-dulu.

etlOperatorCtl

Tidak

Menentukan apakah akan mengonfigurasi fitur ekstrak, transformasi, dan muat (ETL). Nilai yang valid:

  • Y: Ya, konfigurasikan fitur ETL.

  • N: Tidak, jangan konfigurasikan fitur ETL.

etlOperatorSetting

Tidak

Pernyataan pemrosesan data untuk ETL. Untuk informasi selengkapnya, lihat Sintaks DSL pemrosesan data.

etlOperatorColumnReference

Tidak

Bidang khusus untuk layanan T+1. Ini adalah operator ETL.

configKeyMap

Tidak

Informasi konfigurasi untuk operator ETL.

syncArchitecture

Tidak

Topologi sinkronisasi. Nilai yang valid:

  • oneway: sinkronisasi satu arah.

  • bidirectional: sinkronisasi dua arah.

dataCheckConfigure

Tidak

Konfigurasi validasi data. Untuk detailnya, lihat Deskripsi parameter DataCheckConfigure.

dbListCaseChangeMode

Tidak

Kebijakan sensitivitas huruf besar/kecil untuk nama objek di database tujuan. Nilai yang valid:

  • default: Menggunakan kebijakan default DTS.

  • source: Mempertahankan huruf besar/kecil yang sama seperti database sumber.

  • dest_upper: Mengikuti kebijakan default database tujuan (huruf besar).

  • dest_lower: Mengikuti kebijakan default database tujuan (huruf kecil).

maxRetryTime

Tidak

Waktu tunggu sebelum mencoba kembali koneksi ke database sumber atau tujuan setelah terjadi pengecualian yang dapat diprediksi, seperti error jaringan atau lock wait. Nilainya harus bilangan bulat antara 600 hingga 86.400. Satuannya detik. Nilai default adalah 720 menit (43.200 detik). Atur nilai ini minimal 30 menit (1.800 detik).

retry.blind.seconds

Tidak

Waktu tunggu sebelum mencoba kembali setelah terjadi pengecualian tak terduga di database sumber atau tujuan, seperti pengecualian eksekusi DDL atau DML. Nilainya harus bilangan bulat antara 60 hingga 86.340. Satuannya detik. Nilai default adalah 10 menit (600 detik). Atur nilai ini minimal 10 menit (600 detik).

Penting
  • Nilai retry.blind.seconds harus lebih kecil dari nilai maxRetryTime.

  • Jika database memiliki beberapa instans DTS, waktu retry terpendek yang ditetapkan di antara instans DTS tersebut yang digunakan.

modulesExtraConfiguration

Tidak

Item konfigurasi tambahan untuk modul. Untuk informasi tentang parameter dalam item konfigurasi, lihat Deskripsi parameter Parameters.

Format: Array JSON

Contoh:

[
   {
   "module": "07",
   "name": "selectdb.reservoir.group.by.target.schema",
   "value": true
   }
]

Tabel 2. Instans langganan

Parameter

Wajib

Deskripsi

vpcId

Ya

ID virtual private cloud (VPC) tempat instans langganan berada.

vswitchId

Ya

ID virtual switch untuk instans langganan.

startTime

Tidak

Waktu mulai untuk langganan data, sebagai stempel waktu UNIX dalam detik.

endTime

Tidak

Waktu akhir untuk langganan data, sebagai stempel waktu UNIX dalam detik.

Tabel 3. Instans database yang terhubung melalui Cloud Enterprise Network (CEN)

Parameter

Wajib

Deskripsi

srcInstanceId

Tidak

ID instans CEN untuk instans sumber. Contoh:

{
   "srcInstanceId": "cen-9kqshqum*******"  }
Catatan

Konfigurasikan parameter ini ketika instans database sumber terhubung melalui CEN.

destInstanceId

Tidak

ID instans CEN untuk instans tujuan. Contoh:

{
   "destInstanceId": "cen-9kqshqum*******"  }
Catatan

Konfigurasikan parameter ini ketika instans database tujuan terhubung melalui CEN.

Pengaturan parameter database sumber

Konfigurasikan parameter dalam parameter Reserve berdasarkan tipe database sumber.

Tabel 4. Tipe database sumber: MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri)

Parameter

Kondisi konfigurasi

Deskripsi

privilegeMigration

Berlaku ketika database sumber dan tujuan keduanya merupakan RDS for MySQL.

Menentukan apakah akan memigrasikan akun. Nilai yang valid:

  • true: Migrasikan akun.

  • false (default): Jangan migrasikan akun.

privilegeDbList

Informasi tentang akun migrasi. Untuk format parameternya, lihat Pratinjau parameter permintaan OpenAPI. Contoh:

[{\"user\":\"user1\",\"host\":\"%\",\"oldHost\":\"%\",\"is_migrate\":true},{\"user\":\"user2\",\"host\":\"%\",\"oldHost\":\"%\",\"is_migrate\":true}]

definer

Menentukan apakah akan mempertahankan definer asli objek database. Nilainya bisa true atau false.

amp.increment.generator.logmnr.mysql.heartbeat.mode

Ketika database sumber adalah MySQL yang dikelola sendiri.

Menentukan apakah akan menghapus pernyataan SQL tabel heartbeat untuk tugas maju dan balik. Nilai yang valid:

  • none: Tidak menulis informasi SQL heartbeat ke database sumber.

  • N: Menulis informasi SQL heartbeat ke database sumber.

whitelist.dms.online.ddl.enable

Untuk instans sinkronisasi atau migrasi ketika database tujuan adalah MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri), PolarDB for MySQL, AnalyticDB for MySQL, atau AnalyticDB for PostgreSQL.

Gunakan keenam parameter ini bersama-sama untuk mengontrol apakah akan menyalin tabel temporary ke database tujuan. Tabel-tabel ini dihasilkan ketika tool DDL online dijalankan pada tabel sumber.

  • Untuk menyalin data dari tabel temporary yang dibuat oleh perubahan DDL online pada tabel sumber:

    {
       "whitelist.dms.online.ddl.enable": "true",
         "sqlparser.dms.original.ddl": "false",
         "whitelist.ghost.online.ddl.enable": "true",
         "sqlparser.ghost.original.ddl": "false"
    }
  • Jangan menyalin data dari tabel temporary yang dibuat oleh perubahan DDL online. Sebagai gantinya, sinkronkan hanya pernyataan DDL asli yang dieksekusi DMS pada database sumber:

    {
       "whitelist.dms.online.ddl.enable": "false",
         "sqlparser.dms.original.ddl": "true",
         "whitelist.ghost.online.ddl.enable": "false",
         "sqlparser.ghost.original.ddl": "false"
    }
  • Jangan menyalin data dari tabel temporary yang dibuat oleh perubahan DDL online. Sebagai gantinya, sinkronkan hanya pernyataan DDL asli yang dieksekusi gh-ost pada database sumber:

    {
       "whitelist.dms.online.ddl.enable": "false",
         "sqlparser.dms.original.ddl": "false",
         "whitelist.ghost.online.ddl.enable": "false",
         "sqlparser.ghost.original.ddl": "true",
         "online.ddl.shadow.table.rule": "^_(.+)_(?:gho|new)$",
         "online.ddl.trash.table.rule": "^_(.+)_(?:ghc|del|old)$"
    }
    Catatan

    Gunakan ekspresi reguler default atau konfigurasikan sendiri untuk tabel shadow gh-ost (online.ddl.shadow.table.rule) dan tabel sampah (online.ddl.trash.table.rule).

sqlparser.dms.original.ddl

whitelist.ghost.online.ddl.enable

sqlparser.ghost.original.ddl

online.ddl.shadow.table.rule

online.ddl.trash.table.rule

isAnalyzer

Parameter ini hanya berlaku ketika instans sumber dan tujuan keduanya merupakan database MySQL. Ini termasuk RDS MySQL dan MySQL yang dikelola sendiri.

Menentukan apakah akan mengaktifkan fitur evaluasi migrasi. Fitur ini menilai apakah struktur database sumber dan tujuan memenuhi persyaratan. Nilainya bisa true atau false.

srcSSL

Diperlukan ketika jenis koneksi adalah Instans Cloud atau Database yang Dikelola Sendiri di ECS.

Metode koneksi untuk database sumber. Nilai yang valid:

  • 0: Koneksi tanpa enkripsi.

  • 1: Koneksi terenkripsi SSL.

Tabel 5. Tipe database sumber: PolarDB for MySQL

Parameter

Kondisi

Deskripsi

amp.increment.generator.logmnr.mysql.heartbeat.mode

Wajib

Menentukan apakah akan menghapus pernyataan SQL tabel heartbeat untuk tugas maju dan balik. Nilai yang valid:

  • none: Tidak menulis informasi SQL heartbeat ke database sumber.

  • N: Menulis informasi SQL heartbeat ke database sumber.

whitelist.dms.online.ddl.enable

Ketika database tujuan adalah MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri), PolarDB for MySQL, AnalyticDB for MySQL, atau AnalyticDB for PostgreSQL untuk tugas sinkronisasi atau migrasi.

Keenam parameter ini harus digunakan bersama untuk mengontrol apakah akan mereplikasi tabel temporary ke database tujuan. Tabel temporary dihasilkan ketika tool DDL online dijalankan pada tabel sumber.

  • Untuk mereplikasi data dari tabel temporary yang dihasilkan oleh perubahan DDL online pada tabel sumber:

    {
       "whitelist.dms.online.ddl.enable": "true",
         "sqlparser.dms.original.ddl": "false",
         "whitelist.ghost.online.ddl.enable": "true",
         "sqlparser.ghost.original.ddl": "false"
    }
  • Untuk menyinkronkan hanya data DDL asli yang dieksekusi oleh DMS pada database sumber, dan tidak mereplikasi data dari tabel temporary yang dihasilkan oleh perubahan DDL online:

    {
       "whitelist.dms.online.ddl.enable": "false",
         "sqlparser.dms.original.ddl": "true",
         "whitelist.ghost.online.ddl.enable": "false",
         "sqlparser.ghost.original.ddl": "false"
    }
  • Untuk menyinkronkan hanya data DDL asli yang dieksekusi oleh gh-ost pada database sumber, dan tidak mereplikasi data dari tabel temporary yang dihasilkan oleh perubahan DDL online:

    {
       "whitelist.dms.online.ddl.enable": "false",
         "sqlparser.dms.original.ddl": "false",
         "whitelist.ghost.online.ddl.enable": "false",
         "sqlparser.ghost.original.ddl": "true",
         "online.ddl.shadow.table.rule": "^_(.+)_(?:gho|new)$",
         "online.ddl.trash.table.rule": "^_(.+)_(?:ghc|del|old)$"
    }
    Catatan

    Gunakan ekspresi reguler default atau konfigurasikan sendiri untuk tabel shadow gh-ost (online.ddl.shadow.table.rule) dan tabel sampah (online.ddl.trash.table.rule).

sqlparser.dms.original.ddl

whitelist.ghost.online.ddl.enable

sqlparser.ghost.original.ddl

online.ddl.shadow.table.rule

online.ddl.trash.table.rule

Tabel 6. Tipe database sumber: RDS MariaDB

Parameter

Kondisi

Deskripsi

srcSSL

Ketika jenis koneksi adalah Instans Cloud atau Database yang Dikelola Sendiri di ECS.

Metode koneksi untuk database sumber. Nilai yang valid:

  • 0: Koneksi tanpa enkripsi.

  • 1: Koneksi terenkripsi SSL.

Tabel 7. Tipe database sumber: Oracle

Parameter

Kondisi konfigurasi

Deskripsi

isTargetDbCaseSensitive

Wajib jika database tujuan adalah AnalyticDB for PostgreSQL.

Menentukan apakah akan menambahkan tanda kutip pada objek tujuan. Nilai yang valid adalah true dan false.

isNeedAddRowId

Wajib jika database tujuan adalah AnalyticDB for PostgreSQL dan objek untuk sinkronisasi atau migrasi mencakup tabel tanpa primary key.

Menentukan apakah akan menetapkan ROWID sebagai primary key dan kunci distribusi untuk semua tabel tanpa primary key. Nilai yang valid adalah true dan false.

srcOracleType

Wajib

Tipe instans Oracle. Nilai yang valid:

  • sid: Instans non-RAC.

  • serviceName: Instans Real Application Clusters (RAC) atau pluggable database (PDB).

source.column.encoding

Wajib untuk menentukan encoding tulis untuk bisnis Anda.

Encoding tulis untuk bisnis Anda. Encoding yang didukung:

  • default (Default)

  • GB 2312

  • GBK

  • GB 18030

  • UTF-8

  • UTF-16

  • UTF-32

Tabel 8. Tipe database sumber: SQL Server (termasuk ApsaraDB RDS for SQL Server dan SQL Server yang dikelola sendiri)

Parameter

Kondisi konfigurasi

Deskripsi

isTargetDbCaseSensitive

Ketika database tujuan adalah AnalyticDB for PostgreSQL.

Menentukan apakah akan menambahkan tanda kutip pada objek tujuan. Nilai yang valid adalah true dan false.

source.extractor.type

Wajib ketika database tujuan bukan DataHub dan tugas inkremental dikonfigurasi.

Mode untuk sinkronisasi atau migrasi inkremental untuk SQL Server. Nilai yang valid:

  • cdc: Menggunakan penguraian log untuk sinkronisasi atau migrasi inkremental tabel non-heap, dan menggunakan Change Data Capture (CDC) untuk tabel heap.

  • log: Mengurai log database sumber untuk sinkronisasi atau migrasi inkremental.

src.sqlserver.schema.mapper.mode

Ketika database tujuan adalah MySQL (termasuk ApsaraDB RDS for MySQL dan MySQL yang dikelola sendiri), PolarDB for MySQL, atau AnalyticDB for MySQL.

Mode pemetaan struktur antara database sumber dan tujuan. Nilai yang valid:

  • schema.table: Menggunakan SchemaName.TableName dari database sumber sebagai nama tabel tujuan.

  • without.schema: Menggunakan nama tabel dari database sumber sebagai nama tabel tujuan.

    Peringatan

    Jika tabel dengan nama yang sama ada di beberapa skema database sumber, ketidakkonsistenan data atau kegagalan tugas dapat terjadi.

Tabel 9. Tipe database sumber: Tair/Redis

Catatan

Ini mencakup Alibaba Cloud Tair (kompatibel Redis) dan Redis yang dikelola sendiri.

Parameter

Kondisi konfigurasi

Deskripsi

srcKvStoreMode

Wajib ketika jenis koneksi instans database bukan Alibaba Cloud Instance.

Pola instans database Redis sumber yang dikelola sendiri. Nilai yang valid:

  • single: Edisi Dasar.

  • cluster: Edisi Kluster.

any.sink.redis.expire.extension.seconds

Wajib

Waktu tambahan dalam detik untuk memperpanjang waktu hidup (TTL) kunci saat dimigrasikan dari database sumber ke database tujuan. Untuk memastikan konsistensi data, atur TTL tambahan minimal 600 detik jika Anda menggunakan perintah seperti berikut.

EXPIRE key seconds
PEXPIRE key milliseconds
EXPIREAT key timestamp
PEXPIREAT key timestampMs

any.source.redis.use.slave.node

Wajib ketika srcKvStoreMode diatur ke cluster.

Menentukan apakah akan menarik data dari node slave. Nilai yang valid:

  • true: Tarik data dari node slave.

  • false (default): Tarik data dari node master.

Tabel 10. Tipe database sumber: MongoDB (termasuk ApsaraDB for MongoDB dan MongoDB yang dikelola sendiri)

Parameter

Kondisi

Deskripsi

srcEngineArchType

Wajib

Arsitektur database MongoDB sumber. Nilai yang valid:

  • 0: Arsitektur single-node.

  • 1: Arsitektur ReplicaSet.

  • 2: Arsitektur kluster terpartisi.

sourceShardEndpointUsername

Wajib ketika srcEngineArchType diatur ke 2.

Username untuk shard database MongoDB sumber.

sourceShardEndpointPassword

Password untuk shard database MongoDB sumber.

Tabel 11. Tipe database sumber: PolarDB-X 2.0

Parameter

Kondisi konfigurasi

Deskripsi

amp.increment.generator.logmnr.mysql.heartbeat.mode

Wajib

Menentukan apakah akan menulis pernyataan SQL heartbeat untuk tugas maju dan balik. Nilai yang valid:

  • none: Tidak menulis informasi SQL heartbeat ke database sumber.

  • N: Menulis informasi SQL heartbeat ke database sumber.

Tabel 12. Tipe database sumber: PolarDB for PostgreSQL (Kompatibel dengan Oracle)

Parameter

Kondisi

Deskripsi

srcHostPortCtl

Ketika jenis koneksi adalah alamat IP publik.

Menentukan apakah akan menggunakan sumber data tunggal atau ganda untuk PolarDB for PostgreSQL (Kompatibel dengan Oracle). Nilai yang valid:

  • single: Single Data Source.

  • multiple: Multiple Data Sources.

srcHostPorts

Ketika srcHostPortCtl diatur ke multiple.

Alamat IP dan nomor port node PolarDB for PostgreSQL (Kompatibel dengan Oracle) sumber. Pisahkan beberapa pasangan IP:Port dengan koma.

Tabel 13. Tipe database sumber: TiDB

Parameter

Kondisi konfigurasi

Deskripsi

amp.increment.generator.logmnr.mysql.heartbeat.mode

Wajib

Menentukan apakah akan menghapus SQL untuk tabel heartbeat dari tugas maju dan balik:

  • none: Tidak menulis pernyataan SQL heartbeat ke database sumber.

  • N: Menulis pernyataan SQL heartbeat ke database sumber.

isIncMigration

Wajib

Menentukan apakah akan melakukan migrasi inkremental. Nilai yang valid adalah yes atau no.

Penting

Tugas sinkronisasi hanya mendukung yes.

srcKafka

Wajib jika isIncMigration diatur ke yes.

Informasi tentang kluster Kafka downstream TiDB.

taskType

Tipe kluster Kafka. Pilih tipe berdasarkan lokasi penerapan kluster Kafka. Nilai yang valid:

  • EXPRESS: Leased Line / VPN Gateway / Smart Gateway.

  • ECS: Database yang dikelola sendiri yang di-host di instans ECS.

bisId

  • Jika taskType diatur ke ECS, parameter ini menentukan ID instans ECS.

  • Jika taskType diatur ke EXPRESS, parameter ini menentukan ID virtual private cloud (VPC) yang terhubung ke database sumber.

port

Port layanan kluster Kafka.

user

Username untuk kluster Kafka. Biarkan kosong jika autentikasi dinonaktifkan untuk kluster Kafka.

passwd

Password untuk kluster Kafka. Biarkan kosong jika autentikasi dinonaktifkan untuk kluster Kafka.

version

Versi kluster Kafka.

ssl

Metode koneksi untuk kluster Kafka. Nilai yang valid:

  • 0: Koneksi teks biasa.

  • 3: Koneksi terenkripsi menggunakan SCRAM-SHA-256.

topic

Topik yang berisi objek untuk dimigrasikan atau disinkronkan.

host

Wajib jika taskType diatur ke EXPRESS.

Alamat IP kluster Kafka.

vpcId

Wajib jika taskType diatur ke ECS.

VPC tempat instans ECS berada.

Pengaturan parameter database tujuan

Konfigurasikan parameter dalam parameter Reserve berdasarkan tipe database tujuan.

Tabel 14. Tipe database tujuan: MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri)

Parameter

Kondisi konfigurasi

Deskripsi

privilegeMigration

Ketika tipe database sumber dan tujuan keduanya adalah RDS for MySQL. Untuk informasi selengkapnya, lihat Tipe database sumber adalah MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri).

Menentukan apakah akan memigrasikan akun.

privilegeDbList

Informasi tentang akun yang akan dimigrasikan.

definer

Menentukan apakah akan mempertahankan definer asli objek database.

whitelist.dms.online.ddl.enable

Ketika tipe database sumber adalah MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri) atau PolarDB for MySQL, dan instans digunakan untuk sinkronisasi atau migrasi. Untuk informasi selengkapnya, lihat Pengaturan parameter database sumber.

Keenam parameter ini harus digunakan bersama. Mereka mengontrol apakah akan mereplikasi tabel temporary yang dihasilkan oleh tool DDL online untuk tabel sumber ke database tujuan.

sqlparser.dms.original.ddl

whitelist.ghost.online.ddl.enable

sqlparser.ghost.original.ddl

online.ddl.shadow.table.rule

online.ddl.trash.table.rule

isAnalyzer

Ketika tipe database instans sumber dan tujuan keduanya adalah MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri).

Menentukan apakah akan mengaktifkan fitur evaluasi migrasi untuk menilai apakah struktur database sumber dan tujuan memenuhi persyaratan. Nilai yang valid adalah true dan false.

triggerMode

Wajib

Metode untuk memigrasikan trigger dari database sumber. Nilai yang valid:

  • manual: Migrasikan trigger secara manual.

  • auto: Migrasikan trigger secara otomatis.

Catatan

Untuk informasi selengkapnya, lihat Konfigurasi metode untuk menyinkronkan atau memigrasikan trigger.

destSSL

Ketika jenis koneksi adalah Instans Cloud atau Database yang Dikelola Sendiri yang di-host di ECS.

Metode koneksi untuk database tujuan. Nilai yang valid:

  • 0: Koneksi non-terenkripsi.

  • 1: Koneksi aman SSL.

src.sqlserver.schema.mapper.mode

Ketika tipe database sumber adalah SQL Server (termasuk RDS for SQL Server dan SQL Server yang dikelola sendiri).

Mode pemetaan struktur antara database sumber dan tujuan. Untuk informasi selengkapnya, lihat Tipe database sumber adalah SQL Server (termasuk RDS for SQL Server dan SQL Server yang dikelola sendiri).

Tabel 15. Tipe database tujuan: PolarDB for MySQL

Parameter

Kondisi konfigurasi

Deskripsi

whitelist.dms.online.ddl.enable

Ketika tipe database sumber adalah MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri) atau PolarDB for MySQL, dan instans digunakan untuk sinkronisasi atau migrasi. Untuk informasi selengkapnya, lihat Pengaturan parameter database sumber.

Keenam parameter ini harus digunakan bersama. Mereka mengontrol apakah akan mereplikasi tabel temporary yang dihasilkan oleh tool DDL online untuk tabel sumber ke database tujuan.

sqlparser.dms.original.ddl

whitelist.ghost.online.ddl.enable

sqlparser.ghost.original.ddl

online.ddl.shadow.table.rule

online.ddl.trash.table.rule

anySinkTableEngineType

Wajib

Tipe mesin instans PolarDB for MySQL. Nilai yang valid:

  • innodb: Mesin penyimpanan default.

  • xengine: Mesin penyimpanan database OLTP (On-Line Transaction Processing).

triggerMode

Wajib

Metode untuk memigrasikan trigger dari database sumber. Nilai yang valid:

  • manual: Migrasikan trigger secara manual.

  • auto: Migrasikan trigger secara otomatis.

Catatan

Untuk informasi selengkapnya, lihat Konfigurasi metode untuk menyinkronkan atau memigrasikan trigger.

src.sqlserver.schema.mapper.mode

Ketika tipe database sumber adalah SQL Server (termasuk RDS for SQL Server dan SQL Server yang dikelola sendiri).

Mode pemetaan struktur antara database sumber dan tujuan. Untuk informasi selengkapnya, lihat Tipe database sumber adalah SQL Server (termasuk RDS for SQL Server dan SQL Server yang dikelola sendiri).

Tabel 16. Tipe database tujuan: AnalyticDB for MySQL

Parameter

Kondisi konfigurasi

Deskripsi

whitelist.dms.online.ddl.enable

Ketika tipe database sumber adalah MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri) atau PolarDB for MySQL, dan instans digunakan untuk sinkronisasi atau migrasi. Untuk informasi selengkapnya, lihat Pengaturan parameter database sumber.

Keenam parameter ini harus digunakan bersama. Mereka mengontrol apakah akan mereplikasi tabel temporary yang dihasilkan oleh tool DDL online untuk tabel sumber ke database tujuan.

sqlparser.dms.original.ddl

whitelist.ghost.online.ddl.enable

sqlparser.ghost.original.ddl

online.ddl.shadow.table.rule

online.ddl.trash.table.rule

triggerMode

Wajib

Metode untuk memigrasikan trigger dari database sumber. Nilai yang valid:

  • manual: Migrasikan trigger secara manual.

  • auto: Migrasikan trigger secara otomatis.

Catatan

Untuk informasi selengkapnya, lihat Konfigurasi metode untuk menyinkronkan atau memigrasikan trigger.

src.sqlserver.schema.mapper.mode

Ketika tipe database sumber adalah SQL Server (termasuk RDS for SQL Server dan SQL Server yang dikelola sendiri).

Mode pemetaan struktur antara database sumber dan tujuan. Untuk informasi selengkapnya, lihat Tipe database sumber adalah SQL Server (termasuk RDS for SQL Server dan SQL Server yang dikelola sendiri).

traceDatasource

Wajib

Menentukan apakah akan mengaktifkan penggabungan multi-tabel. Nilai yang valid adalah true dan false.

tagColumnValue

Ketika Anda menentukan apakah akan menyesuaikan kolom tag.

Menentukan apakah akan menyesuaikan kolom tag __dts_data_source. Nilai yang valid:

  • tagColumnValue: Sesuaikan kolom tag.

    Penting

    Anda juga perlu mengonfigurasi nilai kolom tag dalam parameter DbList. Untuk informasi selengkapnya, lihat Deskripsi objek untuk migrasi, sinkronisasi, atau langganan.

  • notTagColumnValue: Jangan sesuaikan kolom tag.

    Penting

    Saat ini, hanya instans yang dikonfigurasi setelah pembelian yang mendukung kolom tag kustom.

adsSqlType

Ketika Anda perlu memilih operasi SQL untuk sinkronisasi atau migrasi inkremental di tingkat instans.

Memilih operasi SQL untuk sinkronisasi atau migrasi inkremental di tingkat instans. Pisahkan beberapa operasi SQL dengan koma. Nilai yang valid:

  • insert

  • update

  • delete

  • alterTable

  • truncateTable

  • createTable

  • dropTable

Tabel 17. Tipe database tujuan: AnalyticDB for PostgreSQL

Parameter

Kondisi konfigurasi

Deskripsi

whitelist.dms.online.ddl.enable

Ketika tipe database sumber adalah MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri) atau PolarDB for MySQL, dan instans digunakan untuk sinkronisasi atau migrasi. Untuk informasi selengkapnya, lihat Pengaturan parameter database sumber.

Keenam parameter ini harus digunakan bersama. Mereka mengontrol apakah akan mereplikasi tabel temporary yang dihasilkan oleh tool DDL online untuk tabel sumber ke database tujuan.

sqlparser.dms.original.ddl

whitelist.ghost.online.ddl.enable

sqlparser.ghost.original.ddl

online.ddl.shadow.table.rule

online.ddl.trash.table.rule

isTargetDbCaseSensitive

Ketika tipe database sumber adalah MySQL (termasuk RDS for MySQL dan MySQL yang dikelola sendiri), Oracle, atau SQL Server (termasuk RDS for SQL Server dan SQL Server yang dikelola sendiri).

Menentukan apakah akan menambahkan tanda kutip pada objek tujuan. Nilai yang valid adalah true dan false.

syncOperation

Ketika Anda perlu memilih operasi SQL untuk sinkronisasi atau migrasi inkremental di tingkat instans.

Memilih operasi SQL untuk sinkronisasi atau migrasi inkremental di tingkat instans. Pisahkan beberapa operasi SQL dengan koma. Nilai yang valid:

  • insert

  • update

  • delete

  • alterTable

  • truncateTable

  • createTable

  • dropTable

  • createDB

  • dropDB

Tabel 18. Tipe database tujuan: RDS for MariaDB

Parameter

Kondisi konfigurasi

Deskripsi

triggerMode

Wajib

Metode untuk memigrasikan trigger dari database sumber. Nilai yang valid:

  • manual: Migrasikan trigger secara manual.

  • auto: Migrasikan trigger secara otomatis.

Catatan

Untuk informasi selengkapnya, lihat Konfigurasi metode untuk menyinkronkan atau memigrasikan trigger.

destSSL

Ketika jenis koneksi adalah Instans Cloud atau Database yang Dikelola Sendiri yang di-host di ECS.

Metode koneksi untuk database tujuan. Nilai yang valid:

  • 0: Koneksi non-terenkripsi.

  • 1: Koneksi aman SSL.

Tabel 19. Tipe database tujuan: MongoDB (termasuk ApsaraDB for MongoDB dan MongoDB yang dikelola sendiri)

Parameter

Kondisi konfigurasi

Deskripsi

destEngineArchType

Wajib

Tipe arsitektur database MongoDB tujuan. Nilai yang valid:

  • 0 : Arsitektur single-node.

  • 1: Arsitektur set replika.

  • 2: Arsitektur kluster terpartisi.

Tabel 20. Tipe database tujuan: Tair/Redis

Catatan

Ini mencakup ApsaraDB for Tair (kompatibel Redis) dan Redis yang dikelola sendiri.

Parameter

Kondisi konfigurasi

Deskripsi

destKvStoreMode

Ketika jenis koneksi untuk instans database bukan Alibaba Cloud Instance.

Mode instans Redis tujuan yang dikelola sendiri. Nilai yang valid:

  • single: Edisi Dasar.

  • cluster: Edisi Kluster.

any.sink.redis.expire.extension.seconds

Wajib

Waktu hidup tambahan (TTL) dalam detik untuk kunci saat dimigrasikan dari sumber ke database tujuan. Untuk memastikan konsistensi data, jika Anda menggunakan perintah seperti berikut, atur TTL tambahan kunci minimal 600 detik.

EXPIRE key seconds
PEXPIRE key milliseconds
EXPIREAT key timestamp
PEXPIREAT key timestampMs

Tabel 21. Tipe database tujuan: PolarDB for PostgreSQL (Kompatibel dengan Oracle)

Parameter

Kondisi konfigurasi

Deskripsi

destHostPortCtl

Ketika jenis koneksi adalah IP Publik.

Menentukan apakah akan memilih data multi-sumber untuk PolarDB for PostgreSQL (Kompatibel dengan Oracle). Nilai yang valid:

  • single: Ini sesuai dengan Single Data Source.

  • multiple: Ini sesuai dengan Multiple Data Sources.

destHostPorts

Ketika destHostPortCtl adalah multiple.

Alamat IP dan nomor port node PolarDB for PostgreSQL (Kompatibel dengan Oracle) tujuan. Pisahkan beberapa pasangan IP:Port dengan koma.

Tabel 22. Tipe database tujuan: Oracle

Parameter

Kondisi konfigurasi

Deskripsi

destOracleType

Wajib

Tipe instans Oracle. Nilai yang valid:

  • sid: Instans non-RAC.

  • serviceName: Instans RAC atau PDB.

Tabel 23. Tipe database tujuan: DataHub

Parameter

Kondisi konfigurasi

Deskripsi

isUseNewAttachedColumn

Wajib

Konvensi penamaan untuk kolom terlampir adalah sebagai berikut:

  • Gunakan konvensi penamaan baru untuk kolom terlampir: Atur isUseNewAttachedColumn ke true.

  • Gunakan konvensi penamaan kolom terlampir lama: isUseNewAttachedColumn diatur ke false.

Tabel 24. Tipe database tujuan: MaxCompute

Parameter

Kondisi konfigurasi

Deskripsi

isUseNewAttachedColumn

Wajib

Konvensi penamaan untuk kolom terlampir adalah sebagai berikut:

  • Gunakan konvensi penamaan baru untuk kolom terlampir: Atur isUseNewAttachedColumn ke true.

  • Menggunakan konvensi penamaan kolom terlampir lama: isUseNewAttachedColumn diatur ke false, .

partition

Wajib

Nama partisi tabel log inkremental. Nilai yang valid:

  • Ketika isUseNewAttachedColumn adalah true:

    • modifytime_year

    • modifytime_month

    • modifytime_day

    • modifytime_hour

    • modifytime_minute

  • Ketika isUseNewAttachedColumn adalah false:

    • new_dts_sync_modifytime_year

    • new_dts_sync_modifytime_month

    • new_dts_sync_modifytime_day

    • new_dts_sync_modifytime_hour

    • new_dts_sync_modifytime_minute

Tabel 25. Tipe database tujuan: Elasticsearch

Parameter

Kondisi konfigurasi

Deskripsi

indexMapping

Wajib

Nama indeks yang dibuat di instans Elasticsearch tujuan. Nilai yang valid:

  • tb: Nama indeks yang dibuat sama dengan nama tabel.

  • db_tb: Nama indeks yang dibuat adalah kombinasi dari nama database, garis bawah (_), dan nama tabel.

Tabel 26. Tipe database tujuan: Kafka

Parameter

Kondisi konfigurasi

Deskripsi

destTopic

Wajib

Topik di kluster Kafka tujuan tempat objek migrasi atau sinkronisasi berada.

destVersion

Wajib

Versi kluster Kafka tujuan. Nilai yang valid adalah 1.0, 0.9, dan 0.10.

Catatan

Jika versi kluster Kafka adalah 1.0 atau lebih baru, masukkan 1.0.

destSSL

Wajib

Metode untuk menghubungkan ke kluster Kafka tujuan. Nilai yang valid:

  • 0: Koneksi non-terenkripsi.

  • 3: Koneksi terenkripsi menggunakan SCRAM-SHA-256.

sink.kafka.ddl.topic

Ketika Anda perlu menentukan topik untuk menyimpan informasi DDL.

Topik yang digunakan untuk menyimpan informasi DDL. Jika Anda tidak memasukkan nilai, informasi DDL disimpan di topik yang ditentukan oleh destTopic secara default.

kafkaRecordFormat

Wajib

Format penyimpanan untuk data yang dikirimkan ke kluster Kafka tujuan. Nilai yang valid:

  • canal_json: Menggunakan Canal untuk mengurai log inkremental database dan mengirimkan data inkremental ke kluster Kafka tujuan. Data disimpan dalam format JSON Canal.

  • dts_avro: Format serialisasi data yang mengonversi struktur data atau objek menjadi format yang mudah disimpan atau dikirimkan.

  • shareplex_json: Menggunakan perangkat lunak replikasi data Shareplex untuk membaca data dari database sumber. Saat menulis data ke kluster Kafka tujuan, data disimpan dalam format JSON Shareplex.

  • debezium: Alat yang menangkap perubahan data dan mendukung streaming data update secara real-time dari database sumber ke kluster Kafka tujuan.

Catatan

Untuk informasi selengkapnya tentang format, lihat Format penyimpanan data di antrian pesan.

destKafkaPartitionKey

Wajib

Kebijakan sinkronisasi partisi Kafka. Nilai yang valid:

  • none: Mengirimkan semua data dan informasi DDL ke partisi 0 topik tujuan.

  • database_table: Menggabungkan nama database dan nama tabel untuk dijadikan kunci partisi untuk perhitungan hash. Kemudian, mengirimkan data dan informasi DDL setiap tabel ke partisi berbeda dari topik tujuan.

  • columns: Menggunakan kolom dalam tabel (primary key secara default, atau unique key jika tidak ada primary key) sebagai kunci partisi untuk perhitungan hash. Kemudian, mengirimkan baris berbeda ke partisi berbeda dari topik tujuan. Anda juga dapat menentukan satu atau beberapa kolom sebagai kunci partisi untuk perhitungan hash.

Catatan

Untuk informasi selengkapnya tentang kebijakan sinkronisasi partisi, lihat Kebijakan sinkronisasi partisi Kafka.

destSchemaRegistry

Wajib

Menentukan apakah akan menggunakan Kafka Schema Registry. Nilai yang valid adalah yes dan no.

destKafkaSchemaRegistryUrl

Ketika destSchemaRegistry adalah true.

URL atau alamat IP untuk mendaftarkan skema Avro di Kafka Schema Registry.

Tabel 27. Tipe database tujuan: OSS untuk tugas integrasi danau data terpadu

Parameter

Kondisi konfigurasi

Deskripsi

fusionMetastoreMod

Wajib

Lokasi penyimpanan metadata OSS tujuan (katalog data). Nilai yang valid:

  • dms: Disimpan di DMS.

  • adb: Disimpan di kluster AnalyticDB for MySQL 3.0.

  • none: Tidak ada. Metadata tidak disimpan.

fusionOssFilePath

Wajib

Direktori di OSS tujuan untuk penyimpanan data.

fusionOssFileFormat

Wajib

Format data terintegrasi di OSS tujuan. Nilai yang valid:

  • DELTA: Format Delta.

  • PARQUET: Format Parquet.

  • HUDI: Format Hudi.

fusionAdbCrossMdsDbClusterId

Ketika fusionMetastoreMod adalah adb.

ID kluster AnalyticDB for MySQL 3.0 yang menyimpan metadata OSS tujuan.

fusionAdbCrossMdsRamId

Ketika fusionMetastoreMod adalah adb.

ID Akun Alibaba Cloud atau Pengguna RAM yang memiliki kluster AnalyticDB for MySQL 3.0 yang menyimpan metadata OSS tujuan.

Catatan

Akun atau pengguna harus memiliki izin tulis pada database kluster AnalyticDB for MySQL 3.0.

srcConnArgs

Ketika database sumber adalah MySQL atau SQL Server.

Parameter koneksi database sumber dalam format JSON. Contoh:

"srcConnArgs": {
 "rewriteBatchedStatements": "true",
 "tinyInt1isBit": "false",
 "zeroDateTimeBehavior": "convertToNull",
 "yearIsDateType": "false"
 }

sparkExtraArgs

Ketika Anda mengonfigurasi parameter tugas Spark.

Parameter tugas Spark dalam format JSON. Contoh:

 "sparkExtraArgs": {
 "spark.executor.extraJavaOptions": "-verbose:class",
 "spark.driver.extraJavaOptions": "-verbose:class"
 }