Data Transmission Service:Sinkronisasi ApsaraDB for MongoDB ke PolarDB for MySQL

Prasyarat

• Jika sumber Anda adalah kluster sharded ApsaraDB for MongoDB, ajukan titik akhir untuk setiap node shard dan pastikan semua node menggunakan akun dan kata sandi yang sama. Untuk informasi lebih lanjut, lihat Ajukan titik akhir shard.

• Buat kluster PolarDB for MySQL tujuan dengan ruang penyimpanan lebih besar daripada yang digunakan oleh instans ApsaraDB for MongoDB sumber. Untuk informasi lebih lanjut, lihat Pembelian Kustom dan Beli kluster langganan.

  Catatan

  Kami menyarankan menyediakan ruang penyimpanan 10% lebih besar daripada yang digunakan oleh database sumber.

• Di kluster PolarDB for MySQL tujuan, buat database dan tabel dengan kunci primer. Untuk informasi lebih lanjut, lihat Manajemen database.

  Penting

  • Pastikan tipe data di tabel tujuan kompatibel dengan data MongoDB sumber. Misalnya, jika bidang _id MongoDB berupa ObjectId, kolom yang sesuai di kluster PolarDB for MySQL harus berupa varchar.

  • Jangan beri nama kolom di tabel PolarDB for MySQL tujuan dengan _id atau _value.

Catatan

Penagihan

Jenis sinkronisasi

Izin akun database

Prosedur

1. Buka halaman daftar tugas sinkronisasi di wilayah tujuan. Anda dapat menggunakan salah satu dari dua metode berikut:

   Dari konsol DTS

   1. Masuk ke konsol Data Transmission Service (DTS).

   2. Di panel navigasi kiri, klik Data Synchronization.

   3. Di pojok kiri atas halaman, pilih wilayah tempat instans sinkronisasi berada.

   Dari konsol DMS

   Catatan

   Operasi aktual dapat berbeda tergantung mode dan tata letak konsol DMS. Untuk informasi lebih lanjut, lihat Mode sederhana dan Sesuaikan tata letak dan gaya antarmuka DMS.

   1. Masuk ke Data Management (DMS).

   2. Di bilah menu atas, pilih Data + AI > Data Transmission (DTS) > Data Synchronization.

   3. Di sebelah kanan Data Synchronization Tasks, pilih wilayah tempat instans sinkronisasi berada.

2. Klik Create Task untuk membuka halaman konfigurasi tugas.

3. Konfigurasikan database sumber dan tujuan.

   Kategori	Parameter	Deskripsi
   N/A	Task Name	DTS secara otomatis menghasilkan nama tugas. Kami menyarankan Anda menentukan nama deskriptif untuk memudahkan identifikasi. Nama tidak harus unik.
   Source Database	Select Existing Connection	Untuk menggunakan instans database yang ditambahkan ke sistem (baru dibuat atau disimpan), pilih instans database dari daftar drop-down. Informasi database akan dikonfigurasi secara otomatis. Catatan Di konsol DMS, item konfigurasi ini bernama Select a DMS database instance.. Jika Anda belum menambahkan instans database ke sistem, atau tidak perlu menggunakan instans yang sudah ditambahkan, konfigurasikan informasi database berikut secara manual.
   	Database Type	Pilih MongoDB.
   	Access Method	Pilih Alibaba Cloud Instance.
   	Instance Region	Pilih wilayah instans ApsaraDB for MongoDB sumber.
   	Replicate Data Across Alibaba Cloud Accounts	Contoh ini menggunakan instans database yang dimiliki oleh Akun Alibaba Cloud saat ini. Pilih No.
   	Architecture	Dalam contoh ini, pilih Replica Set. Catatan Jika instans ApsaraDB for MongoDB sumber Anda menggunakan arsitektur Sharded Cluster, Anda juga harus menentukan Shard account dan Shard password.
   	Migration Method	Pilih metode untuk sinkronisasi data inkremental berdasarkan kebutuhan Anda. Oplog (Direkomendasikan): Opsi ini tersedia jika Oplog diaktifkan untuk database sumber. Catatan Oplog diaktifkan secara default untuk database MongoDB yang dikelola sendiri dan instans ApsaraDB for MongoDB. Metode ini menawarkan latensi lebih rendah untuk tugas sinkronisasi inkremental karena log diambil lebih cepat. Kami menyarankan memilih Oplog. ChangeStream: Opsi ini tersedia jika Change Streams diaktifkan untuk database sumber. Catatan Jika database sumber adalah instans Amazon DocumentDB (kluster non-elastis), Anda hanya dapat memilih ChangeStream. Jika Anda mengatur Architecture database sumber ke Sharded Cluster, Anda tidak perlu menentukan Shard account dan Shard password.
   	Instance ID	Pilih ID instans ApsaraDB for MongoDB sumber.
   	Authentication Database	Masukkan database otentikasi untuk akun di instans ApsaraDB for MongoDB sumber. Nilai default adalah admin.
   	Database Account	Masukkan akun database instans ApsaraDB for MongoDB sumber. Untuk informasi tentang izin yang diperlukan, lihat izin akun database.
   	Database Password	Masukkan kata sandi yang sesuai dengan akun database.
   	Encryption	DTS mendukung tiga metode koneksi: Non-encrypted, SSL-encrypted, dan Mongo Atlas SSL. Opsi untuk Encryption bervariasi berdasarkan Access Method dan Architecture yang dipilih. Opsi yang ditampilkan di konsol berlaku. Catatan Database MongoDB dengan Architecture Sharded Cluster dan Migration Method Oplog tidak mendukung SSL-encrypted. Jika sumber adalah database MongoDB yang dikelola sendiri (Access Method bukan Alibaba Cloud Instance) dengan arsitektur Replica Set, dan Anda memilih SSL-encrypted, DTS juga memungkinkan Anda mengunggah sertifikat CA untuk memverifikasi koneksi.
   Destination Database	Select Existing Connection	Untuk menggunakan instans database yang ditambahkan ke sistem (baru dibuat atau disimpan), pilih instans database dari daftar drop-down. Informasi database akan dikonfigurasi secara otomatis. Catatan Di konsol DMS, item konfigurasi ini bernama Select a DMS database instance.. Jika Anda belum menambahkan instans database ke sistem, atau tidak perlu menggunakan instans yang sudah ditambahkan, konfigurasikan informasi database berikut secara manual.
   	Database Type	Pilih PolarDB for MySQL.
   	Access Method	Pilih Alibaba Cloud Instance.
   	Instance Region	Pilih wilayah kluster PolarDB for MySQL tujuan.
   	Replicate Data Across Alibaba Cloud Accounts	Contoh ini menggunakan instans database yang dimiliki oleh Akun Alibaba Cloud saat ini. Pilih No.
   	PolarDB Cluster ID	Pilih ID kluster PolarDB for MySQL tujuan.
   	Database Account	Masukkan akun database kluster PolarDB for MySQL tujuan. Untuk informasi tentang izin yang diperlukan, lihat izin akun database.
   	Database Password	Masukkan kata sandi yang sesuai dengan akun database.
   	Encryption	Pilih metode koneksi. Untuk informasi lebih lanjut tentang enkripsi SSL, lihat Konfigurasi enkripsi SSL.

4. Setelah menyelesaikan konfigurasi, klik Test Connectivity and Proceed di bagian bawah halaman.

   Catatan

   • Pastikan blok CIDR alamat IP server DTS telah ditambahkan ke pengaturan keamanan database sumber dan tujuan untuk mengizinkan akses dari server DTS. Hal ini dapat dilakukan secara otomatis atau manual. Untuk informasi lebih lanjut, lihat Tambahkan blok CIDR alamat IP server DTS ke daftar putih.

   • Jika database sumber atau tujuan adalah database yang dikelola sendiri (di mana Access Method bukan Alibaba Cloud Instance), Anda juga harus mengklik Test Connectivity di kotak dialog CIDR Blocks of DTS Servers.

5. Konfigurasikan objek tugas.

   1. Di halaman Configure Objects, konfigurasikan objek yang akan disinkronkan.

      Parameter	Deskripsi
      Synchronization Types	Incremental Data Synchronization dipilih. Anda hanya dapat memilih Full Data Synchronization. Schema Synchronization tidak didukung. Setelah Pemeriksaan Awal selesai, DTS menyinkronkan data objek yang dipilih dari instans sumber ke kluster tujuan. Ini berfungsi sebagai data garis dasar untuk sinkronisasi data inkremental berikutnya.
      Processing Mode of Conflicting Tables	Precheck and Report Errors: Memeriksa apakah tabel dengan nama yang sama ada di database tujuan. Jika tabel dengan nama yang sama tidak ada, pemeriksaan awal lolos. Jika tabel dengan nama yang sama ada, pemeriksaan awal gagal dan tugas sinkronisasi data tidak dimulai. Catatan Jika Anda tidak dapat menghapus atau mengganti nama tabel dengan nama yang sama di database tujuan, Anda dapat memetakannya ke nama tabel yang berbeda. Untuk informasi lebih lanjut, lihat Petakan nama tabel dan kolom. Ignore Errors and Proceed: Melewati pemeriksaan nama tabel duplikat di database tujuan. Peringatan Memilih Ignore Errors and Proceed dapat menyebabkan ketidakkonsistenan data dan membahayakan bisnis Anda. Misalnya: Jika skema tabel sama dan catatan di database tujuan memiliki nilai kunci primer atau kunci unik yang sama dengan catatan di database sumber: Selama sinkronisasi penuh, DTS mempertahankan catatan di kluster tujuan. Catatan yang sesuai dari database sumber tidak disinkronkan. Selama sinkronisasi inkremental, catatan dari database sumber menimpa catatan di database tujuan. Jika skema tabel berbeda, sinkronisasi data awal mungkin gagal. Hal ini dapat mengakibatkan hanya data kolom parsial yang disinkronkan atau kegagalan sinkronisasi total. Harap berhati-hati.
      Capitalization of Object Names in Destination Instance	Anda dapat mengonfigurasi kebijakan sensitivitas huruf besar/kecil untuk nama objek database, tabel, dan kolom yang disinkronkan ke instans tujuan. Secara default, DTS default policy dipilih. Anda juga dapat memilih untuk menggunakan kebijakan default database sumber dan tujuan. Untuk informasi lebih lanjut, lihat Kebijakan sensitivitas huruf besar/kecil untuk nama objek tujuan.
      Source Objects	Di kotak Source Objects, klik objek yang akan disinkronkan, lalu klik untuk memindahkannya ke kotak Selected Objects. Catatan Anda dapat memilih objek untuk disinkronkan di tingkat koleksi.
      Selected Objects	Edit pemetaan nama database. Di kotak Selected Objects, klik kanan database yang berisi koleksi yang akan disinkronkan. Ubah Schema Name menjadi nama database di kluster PolarDB for MySQL tujuan yang akan menerima data. Klik OK. Edit pemetaan nama tabel. Di kotak Selected Objects, klik kanan koleksi yang akan disinkronkan. Ubah Table Name menjadi nama tabel di kluster PolarDB for MySQL tujuan yang akan menerima data. Opsional: Atur kondisi filter untuk sinkronisasi data penuh. Untuk informasi lebih lanjut, lihat Atur kondisi filter. Sintaksis untuk kondisi filter berbeda dari klausa WHERE SQL standar dan harus menggunakan sintaksis kueri MongoDB. Misalnya, untuk memfilter berdasarkan ID pengguna, masukkan {"_id": {$gt:"user100844658590795****",$lte:"user101674868045948****"}}, di mana $gt berarti "lebih besar dari" dan $lte berarti "kurang dari atau sama dengan". Opsional: Di bagian Select DDL and DML Operations to Be Synchronized, pilih operasi yang akan disinkronkan secara inkremental. Operasi DDL yang tersedia meliputi CREATE INDEX dan DROP INDEX. Operasi DML yang tersedia meliputi insert, update, dan delete. Anda dapat mengklik Select All untuk memilih semua operasi sekaligus. Konfigurasikan bidang MongoDB yang akan disinkronkan. Secara default, DTS memetakan data koleksi dan mengonfigurasi ekspresi di kolom Parameter Value. Verifikasi bahwa ekspresi tersebut memenuhi kebutuhan Anda dan tentukan parameter Column Name, Type, Length, dan Precision. Penting Anda harus memberikan nilai bson_value("_id") ke kolom kunci primer tabel tujuan. Saat Anda mengonfigurasi ekspresi bson_value(), Anda harus menentukan jalur hingga subfield tingkat terendah dalam hierarki. Jika tidak, kehilangan data dapat terjadi atau tugas mungkin gagal. Di kolom Parameter Value, lihat nama bidang MongoDB untuk baris saat ini dalam ekspresi bson_value(). Nama bidang ditentukan dalam tanda kutip ganda (""). Misalnya, jika ekspresinya adalah bson_value("age"), baris tersebut sesuai dengan bidang age di MongoDB. Opsional: Hapus bidang yang tidak perlu disinkronkan. Catatan Untuk menghapus bidang yang tidak perlu disinkronkan, klik ikon di baris yang sesuai. Konfigurasikan bidang yang akan disinkronkan. Lanjutkan berdasarkan apakah ekspresi bson_value() memenuhi kebutuhan Anda. Ekspresi default Masukkan Column Name. Catatan Ini adalah nama kolom di tabel yang menerima data di kluster PolarDB for MySQL tujuan. Pilih Type data untuk kolom tersebut. Penting Pastikan tipe data tabel tujuan kompatibel dengan data di database MongoDB sumber. Untuk informasi lebih lanjut tentang pemetaan tipe data, lihat Pemetaan tipe data. Opsional: Konfigurasikan Length dan Precision untuk data kolom. Ulangi langkah-langkah sebelumnya untuk memetakan semua bidang yang relevan. Ekspresi kustom Catatan Ini mencakup bidang dengan hubungan hierarkis, seperti struktur induk-anak. Di kolom Actions, klik ikon di baris yang sesuai. Klik + Add Column. Konfigurasikan Column Name, Type, Length, dan Precision. Di kotak teks di bawah Parameter Value, masukkan ekspresi bson_value(). Untuk informasi lebih lanjut, lihat Contoh penugasan nilai. Ulangi langkah-langkah sebelumnya untuk memetakan semua bidang yang relevan. Klik OK.

   2. Klik Next: Advanced Settings untuk mengonfigurasi parameter lanjutan.

      Parameter	Deskripsi
      Dedicated Cluster for Task Scheduling	Secara default, DTS menjadwalkan tugas di kluster bersama, dan Anda tidak perlu memilih kluster. Untuk kinerja yang lebih stabil, Anda dapat membeli kluster khusus untuk menjalankan tugas sinkronisasi DTS. Untuk informasi lebih lanjut, lihat Apa itu kluster khusus DTS?.
      Select the engine type of the destination database	Pilih tipe mesin untuk database tujuan. InnoDB: Mesin penyimpanan default. X-Engine: Mesin penyimpanan database untuk pemrosesan transaksi online (OLTP).
      Retry Time for Failed Connections	Setelah tugas sinkronisasi dimulai, jika koneksi ke database sumber atau tujuan gagal, DTS melaporkan error dan segera mulai mencoba menghubungkan kembali. Durasi coba ulang default adalah 720 menit. Anda juga dapat menentukan durasi coba ulang kustom dari 10 hingga 1.440 menit. Kami menyarankan Anda mengatur durasi minimal 30 menit. Jika DTS berhasil terhubung kembali ke database dalam durasi yang ditentukan, tugas sinkronisasi akan dilanjutkan secara otomatis. Jika tidak, tugas gagal. Catatan Jika Anda memiliki beberapa instans DTS (misalnya, Instans A dan Instans B) yang berbagi sumber atau tujuan yang sama, dan Anda mengatur waktu coba ulang jaringan menjadi 30 menit untuk Instans A dan 60 menit untuk Instans B, durasi yang lebih pendek yaitu 30 menit akan digunakan untuk keduanya. Karena DTS mengenakan biaya untuk waktu proses tugas selama periode coba ulang koneksi, kami menyarankan Anda menyesuaikan durasi coba ulang berdasarkan kebutuhan bisnis Anda atau segera melepas instans DTS setelah instans database sumber dan tujuan dilepas.
      Retry Time for Other Issues	Setelah tugas sinkronisasi dimulai, jika terjadi masalah non-konektivitas lainnya pada database sumber atau tujuan (seperti exception eksekusi DDL atau DML), DTS melaporkan error dan segera mulai operasi coba ulang berkelanjutan. Durasi coba ulang default adalah 10 menit. Anda juga dapat menyesuaikan durasi coba ulang dalam rentang 1 hingga 1.440 menit. Kami menyarankan Anda mengaturnya minimal 10 menit. Jika operasi yang relevan berhasil dalam durasi coba ulang yang ditetapkan, tugas sinkronisasi akan dilanjutkan secara otomatis. Jika tidak, tugas gagal. Penting Nilai untuk Retry Time for Other Issues harus lebih kecil daripada nilai untuk Retry Time for Failed Connections.
      Enable Throttling for Full Data Synchronization	Selama tahap sinkronisasi penuh, DTS mengonsumsi sumber daya baca dan tulis dari database sumber dan tujuan, yang dapat meningkatkan beban database. Untuk mengurangi beban pada database sumber dan tujuan, Anda dapat mengatur batas laju untuk tugas sinkronisasi penuh dengan mengonfigurasi parameter Queries per second (QPS) to the source database, RPS of Full Data Migration, dan Data migration speed for full migration (MB/s). Catatan Item konfigurasi ini hanya tersedia ketika Synchronization Types diatur ke Full Data Synchronization. Anda juga dapat menyesuaikan laju sinkronisasi penuh setelah instans sinkronisasi sedang berjalan.
      Only one data type for primary key _id in a table of the data to be synchronized	Menentukan apakah kunci primer _id menggunakan tipe data tunggal dan konsisten dalam setiap koleksi yang akan disinkronkan. Penting Pilih opsi berdasarkan data aktual Anda. Pemilihan yang salah dapat menyebabkan kehilangan data. Parameter ini hanya tersedia jika Synchronization Types mencakup Full Data Synchronization. Yes: Tipe data unik. Selama fase sinkronisasi penuh, DTS tidak memindai tipe data kunci primer di data sumber. Untuk setiap koleksi, DTS hanya menyinkronkan data yang sesuai dengan satu tipe data kunci primer. No: Tipe data tidak unik. Selama fase sinkronisasi penuh, DTS memindai tipe data kunci primer di data sumber dan menyinkronkan semua data.
      Enable Throttling for Incremental Data Synchronization	Anda juga dapat mengatur batas laju untuk tugas sinkronisasi inkremental. Untuk mengurangi tekanan pada database tujuan, atur RPS of Incremental Data Synchronization dan Data synchronization speed for incremental synchronization (MB/s).
      Environment Tag	Pilih tag lingkungan untuk mengidentifikasi instans. Tidak diperlukan tag dalam contoh ini.
      Configure ETL	Pilih apakah akan mengaktifkan fitur ekstrak, transformasi, muat (ETL). Untuk informasi lebih lanjut, lihat Apa itu ETL? Nilai yang valid: Yes: Mengaktifkan fitur ETL. Masukkan pernyataan pemrosesan data di editor kode. Untuk informasi lebih lanjut, lihat Konfigurasi ETL dalam tugas migrasi data atau sinkronisasi data. No: Menonaktifkan fitur ETL.
      Monitoring and Alerting	Tentukan apakah akan mengonfigurasi peringatan. Jika sinkronisasi gagal atau latensi melebihi ambang batas yang ditentukan, notifikasi akan dikirim ke kontak peringatan. No: Tidak ada peringatan yang dikonfigurasi. Yes: Konfigurasikan peringatan dengan mengatur ambang batas peringatan dan menentukan notifikasi peringatan. Untuk informasi lebih lanjut, lihat Konfigurasi pemantauan dan peringatan selama konfigurasi tugas.

6. Simpan tugas dan jalankan pemeriksaan awal.

   • Untuk melihat parameter API untuk mengonfigurasi instans ini, arahkan kursor ke tombol Next: Save Task Settings and Precheck dan klik Preview OpenAPI parameters di gelembung.

   • Jika Anda telah selesai melihat parameter API, klik Next: Save Task Settings and Precheck di bagian bawah halaman.

   Catatan

   • Sebelum pekerjaan sinkronisasi dimulai, DTS menjalankan pemeriksaan awal. Pekerjaan hanya dapat dimulai setelah semua item pemeriksaan awal lolos.

   • Jika pemeriksaan awal gagal, klik View Details untuk item yang gagal. Perbaiki masalah sesuai petunjuk, lalu jalankan pemeriksaan awal lagi.

   • Jika pemeriksaan awal mengembalikan peringatan:

     • Jika item pemeriksaan gagal dan tidak dapat diabaikan, klik View Details di sebelah item tersebut. Ikuti petunjuk untuk memperbaiki masalah, lalu jalankan pemeriksaan awal lagi.

     • Untuk item pemeriksaan yang dapat diabaikan, Anda dapat mengklik Confirm Alert Details, Ignore, OK, dan Precheck Again secara berurutan untuk melewati peringatan dan menjalankan kembali pemeriksaan awal. Jika Anda memilih untuk menyembunyikan item peringatan, hal ini dapat menyebabkan masalah seperti ketidakkonsistenan data dan menimbulkan risiko bagi bisnis Anda.

7. Beli instans.

   1. Ketika Success Rate mencapai 100%, klik Next: Purchase Instance.

   2. Di halaman Purchase, pilih metode penagihan dan spesifikasi tautan untuk instans sinkronisasi data. Tabel berikut menjelaskan parameter ini secara rinci.

      Kategori	Parameter	Deskripsi
      New Instance Class	Metode Penagihan	Langganan: Anda membayar saat membuat instans. Ini cocok untuk kebutuhan jangka panjang dan lebih hemat biaya daripada bayar sesuai penggunaan. Semakin lama durasi langganan, semakin tinggi diskonnya. Bayar sesuai penggunaan: Anda dikenai biaya per jam. Ini cocok untuk kebutuhan jangka pendek. Anda dapat melepas instans segera setelah digunakan untuk menghemat biaya.
      	Konfigurasi Kelompok Sumber Daya	Kelompok sumber daya tempat instans tersebut berada. Defaultnya adalah kelompok sumber daya default. Untuk informasi lebih lanjut, lihat Apa itu Manajemen Sumber Daya?.
      	Spesifikasi Tautan	DTS menyediakan spesifikasi sinkronisasi dengan tingkat kinerja berbeda. Spesifikasi tautan sinkronisasi memengaruhi laju sinkronisasi. Anda dapat memilih spesifikasi berdasarkan skenario bisnis Anda. Untuk informasi lebih lanjut, lihat Spesifikasi tautan sinkronisasi data.
      	Durasi Langganan	Dalam mode langganan, pilih durasi dan jumlah untuk instans langganan. Anda dapat memilih langganan bulanan dari 1 hingga 9 bulan, atau langganan tahunan 1, 2, 3, atau 5 tahun. Catatan Opsi ini hanya tersedia ketika metode penagihan adalah Subscription.

   3. Setelah menyelesaikan konfigurasi, baca dan pilih Data Transmission Service (Pay-as-you-go) Service Terms.

   4. Klik Buy and Start. Di kotak dialog OK, klik OK.

      Anda dapat melihat progres tugas di halaman Sinkronisasi Data.

Pemetaan tipe data

Contoh konfigurasi penugasan

{
  "_id":"62cd344c85c1ea6a2a9f****",
  "person":{
    "name":"neo",
    "age":26,
    "sex":"male"
  }
}