Migrasi dari MongoDB ke AnalyticDB for MySQL V3.0 - Data Transmission Service

Anda dapat menggunakan Data Transmission Service (DTS) untuk melakukan migrasi data dari instans ApsaraDB for MongoDB tipe replica set ke kluster AnalyticDB for MySQL 3.0.

Prasyarat

Jika sumbernya adalah kluster sharded ApsaraDB for MongoDB, ajukan endpoint untuk setiap shard. Semua shard harus menggunakan username dan password yang sama. Untuk informasi lebih lanjut, lihat Ajukan endpoint shard.
Anda memiliki kluster tujuan AnalyticDB for MySQL 3.0 dengan ruang penyimpanan lebih besar daripada ruang penyimpanan yang digunakan oleh instans sumber ApsaraDB for MongoDB. Untuk informasi lebih lanjut, lihat Buat kluster.

Catatan
Instans tujuan harus memiliki ruang penyimpanan minimal 10% lebih besar daripada ruang yang digunakan oleh instans sumber.
Di kluster tujuan AnalyticDB for MySQL 3.0, Anda telah membuat database dan tabel dengan kunci primer. Untuk informasi lebih lanjut, lihat CREATE DATABASE dan CREATE TABLE.
Penting
- Tipe data di tabel tujuan harus kompatibel dengan data MongoDB sumber. Misalnya, jika field _id di MongoDB bertipe ObjectId, tipe data yang sesuai di kluster AnalyticDB for MySQL 3.0 harus varchar.
- Di kluster AnalyticDB for MySQL 3.0, jangan beri nama kolom tabel tujuan _id atau _value.
Jalankan perintah SET ADB_CONFIG ALLOW_MULTI_QUERIES=true; di kluster tujuan AnalyticDB for MySQL 3.0 untuk mengaktifkan Multi-Statement.

Catatan
Hanya kluster dengan versi minor 3.1.9.3 atau lebih baru yang mendukung Multi-Statement. Untuk melihat dan meningkatkan versi minor, lihat Tingkatkan versi minor.

Catatan penggunaan

Type	Deskripsi
Batasan pada database sumber	Kebutuhan bandwidth: Bandwidth egress yang tidak mencukupi pada server database sumber akan memperlambat migrasi data. Saat memetakan nama koleksi atau melakukan pengeditan lainnya, satu tugas migrasi hanya mendukung hingga 1.000 koleksi. Jika melebihi batas ini, tugas akan gagal saat dikirim. Sebagai solusi, bagi koleksi menjadi batch yang lebih kecil dan buat tugas migrasi terpisah untuk masing-masing batch. Jika database sumber adalah instans MongoDB dengan arsitektur satu node, instans Azure Cosmos DB for MongoDB, atau kluster elastis Amazon DocumentDB, hanya migrasi penuh yang didukung. Untuk melakukan migrasi data inkremental: Database sumber harus memiliki oplog yang diaktifkan dengan retensi minimal tujuh hari. Atau, change streams harus diaktifkan, dan DTS harus dapat berlangganan perubahan data dari database sumber dalam tujuh hari terakhir melalui change streams. Jika persyaratan ini tidak terpenuhi, tugas migrasi mungkin gagal karena tidak dapat memperoleh perubahan data dari sumber. Dalam kasus ekstrem, hal ini dapat menyebabkan ketidakkonsistenan atau kehilangan data. Masalah yang timbul akibat hal ini tidak dicakup oleh Perjanjian Tingkat Layanan (SLA) DTS. Penting Kami menyarankan menggunakan oplog untuk memperoleh perubahan data dari database sumber. Hanya MongoDB versi 4.0 dan yang lebih baru yang mendukung perolehan perubahan data melalui change streams. Jika database sumber adalah kluster Amazon DocumentDB (non-elastis), Anda harus mengaktifkan change streams secara manual. Saat mengonfigurasi tugas, atur Migration Method ke ChangeStream dan Architecture ke Sharded Cluster. Jika sumbernya adalah instans MongoDB dengan arsitektur kluster sharded, field _id pada koleksi yang akan dimigrasikan harus unik. Jika tidak, ketidakkonsistenan data dapat terjadi. Jika instans sumber adalah database MongoDB yang dikelola sendiri dengan arsitektur kluster sharded: Access Method hanya mendukung Public IP Address, Express Connect, VPN Gateway, or Smart Access Gateway, dan Cloud Enterprise Network (CEN). Jika database sumber adalah MongoDB 8.0 atau lebih baru dan Migration Method adalah Oplog, Anda harus memastikan bahwa akun shard yang digunakan oleh tugas migrasi memiliki izin `directShardOperations`. Anda dapat memberikan izin ini dengan menjalankan perintah berikut: `db.adminCommand({ grantRolesToUser: "username", roles: [{ role: "directShardOperations", db: "admin"}]})` Note Ganti `username` dalam perintah dengan akun shard untuk tugas migrasi. Jika Migration Method adalah Oplog dan tugas mencakup migrasi penuh, berikan izin kepada akun mongos dari kluster sharded MongoDB sumber untuk menjalankan perintah `db.runCommand({"balancerStatus":1})`. DTS menggunakan perintah ini selama Pemeriksaan Awal untuk memverifikasi bahwa balancer database sumber dinonaktifkan. DTS tidak mendukung koneksi ke database MongoDB menggunakan Rekaman SRV. Jika sumbernya adalah instans kluster sharded MongoDB, jumlah node mongos tidak boleh melebihi 10. Anda juga harus menghapus dokumen orphan dari kluster tersebut. Jika tidak, migrasi mungkin gagal atau menyebabkan ketidakkonsistenan data. Untuk informasi lebih lanjut, lihat Orphaned Documents dan Cara Membersihkan Dokumen Orphan di Kluster Sharded MongoDB. Batasan operasional pada database sumber: Selama fase migrasi penuh, jangan lakukan perubahan skema pada database atau koleksi, termasuk pembaruan data bertipe array. Jika dilakukan, tugas migrasi mungkin gagal atau menyebabkan ketidakkonsistenan data. Jika Anda hanya melakukan migrasi penuh, jangan menulis data baru ke instans sumber. Jika dilakukan, ketidakkonsistenan data dapat terjadi. Jika sumbernya adalah instans kluster sharded MongoDB, jangan jalankan perintah yang mengubah distribusi data objek yang akan dimigrasikan, seperti shardCollection, reshardCollection, unshardCollection, moveCollection, dan movePrimary, selama tugas migrasi berjalan. Jika dilakukan, ketidakkonsistenan data dapat terjadi. Jika sumbernya adalah instans MongoDB dengan arsitektur kluster sharded, aktivitas penyeimbangan ulang (rebalancing) oleh balancer dapat meningkatkan latensi migrasi.
Batasan lainnya	Hanya migrasi tingkat koleksi yang didukung. Database tujuan harus memiliki kunci primer kustom. Atau, pada langkah Configurations for Databases, Tables, and Columns, atur Primary Key Column. Jika tidak, migrasi mungkin gagal. Tabel tujuan di kluster AnalyticDB for MySQL 3.0 harus memiliki satu kolom kunci primer saja. kunci primer komposit tidak didukung. Saat mengonfigurasi field migrasi di bagian Selected Objects, Anda harus mengatur Parameter Value untuk kolom kunci primer ini menjadi `bson_value("_id")`. Tabel tujuan di kluster AnalyticDB for MySQL 3.0 tidak boleh memiliki field bernama _id atau _value. Jika memiliki, migrasi akan gagal. Karena batasan penggunaan AnalyticDB for MySQL 3.0, jika penggunaan ruang disk sebuah node dalam kluster melebihi 80%, tugas DTS mungkin terganggu dan mengalami latensi. Perkirakan ruang yang dibutuhkan untuk objek yang dimigrasikan agar kluster tujuan memiliki ruang penyimpanan yang cukup. Jika tipe data di kluster AnalyticDB for MySQL 3.0 tidak kompatibel dengan data MongoDB, tugas akan gagal. Jika kluster tujuan AnalyticDB for MySQL 3.0 sedang melakukan backup saat tugas DTS berjalan, tugas akan gagal. DTS tidak mendukung migrasi data dari database admin, config, atau local. Informasi transaksi tidak dipertahankan. Transaksi di database sumber dikonversi menjadi catatan tunggal di database tujuan. Sebelum melakukan migrasi data, evaluasi kinerja database sumber dan tujuan. Kami juga menyarankan melakukan migrasi data pada jam sepi. Jika tidak, DTS akan mengonsumsi sumber daya baca dan tulis pada kedua database selama migrasi penuh, yang dapat meningkatkan beban database. Selama migrasi penuh, DTS melakukan operasi INSERT secara konkuren. Hal ini dapat menyebabkan fragmentasi pada koleksi tujuan. Akibatnya, koleksi di database tujuan akan menggunakan ruang penyimpanan lebih besar daripada di instans sumber. Konfirmasi apakah presisi migrasi yang digunakan DTS untuk tipe data FLOAT atau DOUBLE memenuhi kebutuhan bisnis Anda. DTS membaca nilai tipe ini menggunakan `ROUND(COLUMN,PRECISION)`. Jika Anda tidak secara eksplisit menentukan presisi, DTS akan memigrasikan nilai FLOAT dengan presisi 38 digit dan nilai DOUBLE dengan presisi 308 digit. DTS mencoba melanjutkan tugas migrasi yang gagal dalam waktu tujuh hari. Sebelum beralih ke instans tujuan, Anda harus mengakhiri atau melepas tugas tersebut, atau menjalankan perintah `revoke` untuk mencabut izin tulis akun yang digunakan DTS untuk mengakses instans tujuan. Hal ini mencegah data sumber menimpa data tujuan jika tugas dilanjutkan secara otomatis. DTS menghitung latensi migrasi inkremental dengan membandingkan timestamp catatan data terakhir yang dimigrasikan ke database tujuan dengan timestamp saat ini. Jika database sumber tidak diperbarui dalam periode yang lama, latensi yang dilaporkan mungkin tidak akurat. Jika tugas menunjukkan latensi berlebihan, Anda dapat melakukan pembaruan pada database sumber untuk memperbarui pembacaan latensi. Koleksi time series, yang diperkenalkan di MongoDB 5.0, tidak didukung untuk migrasi. Jika tugas gagal, staf dukungan DTS akan mencoba memulihkannya dalam waktu delapan jam. Selama pemulihan, mereka mungkin me-restart tugas atau menyesuaikan parameternya. Catatan Hanya parameter tugas DTS yang dimodifikasi—bukan parameter database. Parameter yang mungkin disesuaikan termasuk yang tercantum di Modifikasi parameter instans. Saat database tujuan adalah AnalyticDB for MySQL, DTS hanya mendukung penulisan tipe data yang didukung oleh database tersebut, termasuk tipe data dasar dan tipe data kompleks seperti ARRAY, MAP, dan JSON. DTS tidak mendukung penulisan tipe lainnya, seperti MULTIVALUE.

Penagihan

Tipe migrasi	Biaya konfigurasi tugas	Biaya transfer data
migrasi data penuh	Gratis.	Tutorial ini gratis. Namun, biaya transfer data berlaku jika Access Method untuk database tujuan adalah Public IP Address.
migrasi data inkremental	Biaya berlaku. Untuk detailnya, lihat ikhtisar penagihan.

Tipe migrasi

Tipe	Deskripsi
Migrasi data penuh	Memigrasikan semua data yang ada dari instans sumber ApsaraDB for MongoDB ke kluster tujuan AnalyticDB for MySQL 3.0.
Migrasi data inkremental	Memigrasikan pembaruan inkremental dari instans sumber ApsaraDB for MongoDB ke kluster tujuan AnalyticDB for MySQL 3.0 setelah migrasi data penuh selesai. Catatan Hanya mendukung operasi insert, update, dan delete pada dokumen dalam sebuah koleksi. Untuk pembaruan dokumen inkremental, hanya perubahan yang dilakukan menggunakan perintah `$set` yang direplikasi.

Izin akun database

Database	Migrasi data penuh	Migrasi data inkremental	Aksi
Instans sumber ApsaraDB for MongoDB	Izin baca pada database sumber.	Izin baca pada database sumber, database admin, dan database local.	Manajemen akun
Kluster tujuan AnalyticDB for MySQL 3.0	Izin baca dan tulis pada database tujuan.		Buat Akun Database

Catatan

Jika Anda menggunakan ChangeStream sebagai metode migrasi inkremental, akun database sumber memerlukan izin baca Change Streams di seluruh instans (seperti readAnyDatabase). Jika sumbernya adalah instans ApsaraDB for MongoDB dengan akun kustom, Anda juga harus memberikan izin baca pada database admin. Untuk detailnya, lihat Izin akun root yang ditentukan saat pembuatan instans.

Prosedur

Buka halaman daftar tugas migrasi untuk wilayah tujuan menggunakan salah satu metode berikut.
Dari Konsol DTS
1. Masuk ke Konsol Data Transmission Service (DTS).
2. Di panel navigasi kiri, klik Data Migration.
3. Di pojok kiri atas halaman, pilih wilayah tempat instans migrasi berada.
Dari Konsol DMS

Catatan
Operasi aktual mungkin berbeda tergantung pada mode dan tata letak Konsol DMS. Untuk informasi lebih lanjut, lihat Konsol mode sederhana dan Sesuaikan tata letak dan gaya Konsol DMS.
1. Masuk ke Konsol Data Management (DMS).
2. Di bilah menu atas, pilih Data + AI > Data Transmission (DTS) > Data Migration.
3. Di sebelah kanan Data Migration Tasks, pilih wilayah tempat instans migrasi berada.
Klik Create Task untuk membuka halaman konfigurasi tugas.

Konfigurasikan database sumber dan tujuan.

Kategori	Parameter	Deskripsi
N/A	Task Name	DTS secara otomatis menghasilkan nama tugas. Kami menyarankan Anda menentukan nama deskriptif agar mudah diidentifikasi. Nama ini tidak harus unik.
Source Database	Select Existing Connection	Untuk menggunakan instans database yang telah ditambahkan ke sistem (dibuat atau disimpan), pilih instans database yang diinginkan dari daftar drop-down. Informasi database di bawah akan dikonfigurasi secara otomatis. Catatan Di Konsol DMS, parameter ini bernama Select a DMS database instance.. Jika Anda belum mendaftarkan instans database ke sistem, atau tidak perlu menggunakan instans yang terdaftar, konfigurasikan informasi database secara manual di bawah.
	Database Type	Pilih MongoDB.
	Access Method	Pilih Alibaba Cloud Instance.
	Instance Region	Pilih wilayah instans sumber ApsaraDB for MongoDB.
	Replicate Data Across Alibaba Cloud Accounts	Dalam contoh ini, digunakan instans database di bawah Akun Alibaba Cloud saat ini. Pilih No.
	Architecture	Contoh ini memilih Replica Set. Catatan Jika instans sumber ApsaraDB for MongoDB Anda menggunakan Sharded Cluster, Anda juga harus menentukan Shard account dan Shard password.
	Migration Method	Pilih metode untuk migrasi data inkremental sesuai kebutuhan Anda. Oplog (Direkomendasikan): Opsi ini tersedia jika oplog diaktifkan untuk database sumber. Catatan Oplog diaktifkan secara default baik untuk database MongoDB yang dikelola sendiri maupun instans ApsaraDB for MongoDB. Metode ini menawarkan latensi lebih rendah untuk migrasi data inkremental karena penarikan log lebih cepat. Oleh karena itu, kami merekomendasikan 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 ke Sharded Cluster untuk database sumber, Anda tidak perlu memasukkan Shard account atau Shard password.
	Instance ID	Pilih ID instans sumber ApsaraDB for MongoDB.
	Authentication Database	Masukkan nama database autentikasi untuk instans sumber ApsaraDB for MongoDB. Nilai default-nya adalah admin.
	Database Account	Masukkan akun database instans sumber ApsaraDB for MongoDB. Untuk informasi tentang izin yang diperlukan, lihat Izin yang diperlukan untuk akun database.
	Database Password	Masukkan password 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 sumbernya 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 telah ditambahkan ke sistem (dibuat atau disimpan), pilih instans database yang diinginkan dari daftar drop-down. Informasi database di bawah akan dikonfigurasi secara otomatis. Catatan Di Konsol DMS, parameter ini bernama Select a DMS database instance.. Jika Anda belum mendaftarkan instans database ke sistem, atau tidak perlu menggunakan instans yang terdaftar, konfigurasikan informasi database secara manual di bawah.
	Database Type	Pilih AnalyticDB for MySQL 3.0.
	Access Method	Pilih Alibaba Cloud Instance.
	Instance Region	Pilih wilayah kluster tujuan AnalyticDB for MySQL 3.0.
	Instance ID	Pilih ID kluster tujuan AnalyticDB for MySQL 3.0.
	Database Account	Masukkan akun database kluster tujuan AnalyticDB for MySQL 3.0. Untuk informasi tentang izin yang diperlukan, lihat Izin yang diperlukan untuk akun database.
	Database Password	Masukkan password yang sesuai dengan akun database.

Setelah menyelesaikan konfigurasi, klik Test Connectivity and Proceed di bagian bawah halaman.
Catatan
- Pastikan segmen alamat IP layanan DTS telah ditambahkan secara otomatis atau manual ke pengaturan keamanan database sumber dan tujuan untuk mengizinkan akses dari server DTS. Untuk informasi lebih lanjut, lihat Tambahkan alamat IP server DTS ke daftar putih.
- Jika database sumber atau tujuan adalah database yang dikelola sendiri (Access Method bukan Alibaba Cloud Instance), Anda juga harus mengklik Test Connectivity di kotak dialog CIDR Blocks of DTS Servers yang muncul.

Konfigurasikan objek tugas.

Di halaman Configure Objects, konfigurasikan objek yang ingin dimigrasikan.

Parameter	Deskripsi
Migration Types	Jika Anda hanya perlu melakukan migrasi penuh, pilih Full Data Migration. Untuk melakukan migrasi tanpa downtime, pilih kedua opsi Full Data Migration dan Incremental Data Migration. Catatan Jika Anda tidak memilih Incremental Data Migration, jangan menulis data baru ke instans sumber selama migrasi data untuk memastikan konsistensi data.
DDL and DML Operations to Be Synchronized	Pilih operasi yang akan dimigrasikan pada tingkat instans selama migrasi inkremental. Catatan Untuk memilih operasi inkremental pada tingkat koleksi, klik kanan objek migrasi di bagian Selected Objects dan pilih operasi di kotak dialog yang muncul.
Merge Tables	Jika Anda memilih Yes, DTS menambahkan kolom `__dts_data_source` ke setiap tabel untuk mencatat sumber data. Untuk informasi lebih lanjut, lihat Aktifkan penggabungan multi-tabel. Jika Anda memilih No, ini adalah opsi default. Catatan Fitur penggabungan tabel dikonfigurasi pada tingkat tugas, bukan tingkat tabel. Untuk menggabungkan beberapa tabel tetapi tidak yang lain, Anda harus membuat dua tugas migrasi data terpisah. Peringatan Jangan lakukan operasi DDL untuk mengubah skema database atau tabel sumber. Jika dilakukan, ketidakkonsistenan data atau kegagalan tugas dapat terjadi.
Processing Mode of Conflicting Tables	Precheck and Report Errors: Memeriksa apakah koleksi dengan nama yang sama ada di database tujuan. Jika tidak ada koleksi dengan nama yang sama, pemeriksaan awal lolos. Jika ada koleksi dengan nama yang sama, kesalahan dilaporkan selama pemeriksaan awal, dan tugas migrasi data tidak dimulai. Catatan Jika koleksi di database tujuan memiliki nama yang sama tetapi tidak dapat dengan mudah dihapus atau diganti namanya, Anda dapat mengubah nama koleksi di database tujuan. Untuk informasi lebih lanjut, lihat Pemetaan nama objek. Ignore Errors and Proceed: Melewati pemeriksaan untuk koleksi dengan nama yang sama. Peringatan Memilih Ignore Errors and Proceed dapat menyebabkan ketidakkonsistenan data dan risiko bisnis. Misalnya: Jika catatan di database tujuan memiliki nilai kunci primer yang sama dengan catatan di database sumber, catatan di database tujuan dipertahankan. Catatan dari database sumber tidak dimigrasikan ke database tujuan. Inisialisasi data mungkin gagal, hanya sebagian data yang dimigrasikan, atau migrasi gagal.
Source Objects	Di kotak Source Objects, klik objek yang akan dimigrasikan, lalu klik untuk memindahkannya ke kotak Selected Objects. Catatan Objek migrasi dapat dipilih pada tingkat koleksi.
Selected Objects	Edit pemetaan nama database. Di kotak Selected Objects, klik kanan database yang berisi koleksi yang akan dimigrasikan. Ubah Schema Name menjadi nama database tujuan di kluster AnalyticDB for MySQL 3.0. Di kotak dialog Edit Schema yang muncul, ubah Schema Name (misalnya, menjadi `dtsdb`). Opsional: Di bagian Select DDL and DML Operations to Be Synchronized, pilih operasi DML yang akan dimigrasikan, seperti insert, update, dan delete. Klik OK. Edit pemetaan nama tabel. Di kotak Selected Objects, klik kanan koleksi yang akan dimigrasikan. Panel Selected Objects menampilkan struktur objek di database (seperti dtsdb), termasuk tipe objek (seperti Table) dan objek spesifik (seperti class). Ubah Table Name menjadi nama tabel tujuan di kluster AnalyticDB for MySQL 3.0. Di halaman Edit Table yang muncul, Anda dapat mengubah Table Name (misalnya, `class`). Setelah mengedit nama tabel atau kolom, nama di database tujuan akan diperbarui sesuai. Opsional: Atur kondisi filter untuk migrasi penuh. Untuk informasi lebih lanjut, lihat Atur kondisi filter. Untuk ApsaraDB for MongoDB, sintaks kondisi filter berbeda dari klausa WHERE SQL standar. 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 DML yang akan dimigrasikan, seperti insert, update, dan delete. Konfigurasikan field MongoDB yang akan dimigrasikan. Secara default, DTS memetakan data koleksi yang akan dimigrasikan dan mengonfigurasi ekspresi di kolom Parameter Value. Periksa apakah ekspresi tersebut memenuhi kebutuhan Anda dan konfigurasikan parameter seperti Column Name, Type, Length, dan Precision. Penting Kolom kunci primer tabel tujuan harus diberi nilai `bson_value("_id")`. Saat mengonfigurasi ekspresi `bson_value()`, tentukan hierarki hingga subfield tingkat terendah. Jika tidak, kehilangan data atau kegagalan tugas dapat terjadi. Di kolom Parameter Value, lihat nama field MongoDB di ekspresi `bson_value()`. Konten di dalam tanda kutip (`""`) adalah nama field MongoDB. Misalnya, jika ekspresinya adalah `bson_value("age")`, baris ini sesuai dengan field `age` di MongoDB. Opsional: Hapus field yang tidak perlu dimigrasikan. Catatan Untuk menghapus field yang tidak perlu dimigrasikan, klik ikon di baris tersebut. Konfigurasikan field yang akan dimigrasikan. Lakukan operasi berikut berdasarkan apakah ekspresi `bson_value()` memenuhi kebutuhan Anda. Ekspresi yang cocok Masukkan Column Name. Catatan Masukkan nama kolom di tabel tujuan di kluster AnalyticDB for MySQL 3.0. Pilih Type data untuk kolom tersebut. Penting Pastikan tipe data tabel tujuan kompatibel dengan data MongoDB sumber. Untuk informasi tentang pemetaan tipe data, lihat Pemetaan tipe data. Opsional: Konfigurasikan Length dan Precision untuk data kolom. Ulangi langkah-langkah ini untuk memetakan semua field yang relevan. Ekspresi yang tidak cocok Catatan Contohnya adalah field dengan struktur hirarkis (bersarang). Di kolom Operation, klik ikon di baris field tersebut. 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 konfigurasi penugasan. Ulangi langkah-langkah ini untuk memetakan semua field yang relevan. Klik OK.

Klik Next: Advanced Settings untuk mengonfigurasi parameter lanjutan.

Parameter	Deskripsi
Dedicated Cluster for Task Scheduling	Secara default, DTS menjadwalkan tugas pada kluster bersama. Anda tidak perlu memilih satu. Jika Anda menginginkan tugas yang lebih stabil, Anda dapat membeli klaster khusus untuk menjalankan tugas migrasi DTS.
Retry Time for Failed Connections	Setelah tugas migrasi dimulai, jika koneksi ke database sumber atau tujuan gagal, DTS melaporkan kesalahan dan segera mulai mencoba menghubungkan kembali. Durasi percobaan ulang default adalah 720 menit. Anda dapat menyesuaikan waktu percobaan ulang ke nilai antara 10 hingga 1440 menit. Kami menyarankan Anda mengatur durasi lebih dari 30 menit. Jika DTS berhasil terhubung kembali ke database sumber dan tujuan dalam durasi yang ditentukan, tugas migrasi akan dilanjutkan secara otomatis. Jika tidak, tugas gagal. Catatan Untuk beberapa instans DTS yang berbagi sumber atau tujuan yang sama, waktu percobaan ulang jaringan ditentukan oleh pengaturan tugas yang dibuat terakhir. Karena Anda dikenai biaya untuk tugas selama periode percobaan ulang koneksi, kami menyarankan Anda menyesuaikan waktu percobaan ulang berdasarkan kebutuhan bisnis Anda, atau segera melepas instans DTS setelah instans database sumber dan tujuan dilepas.
Retry Time for Other Issues	Setelah tugas migrasi dimulai, jika terjadi masalah non-konektivitas, seperti pengecualian eksekusi DDL atau DML, di database sumber atau tujuan, DTS melaporkan kesalahan dan segera mulai mencoba mengulang operasi tersebut. Durasi percobaan ulang default adalah 10 menit. Anda dapat menyesuaikan waktu percobaan ulang ke nilai antara 1 hingga 1440 menit. Kami menyarankan Anda mengatur durasi lebih dari 10 menit. Jika operasi terkait berhasil dalam durasi percobaan ulang yang ditentukan, tugas migrasi akan dilanjutkan secara otomatis. Jika tidak, tugas gagal. Penting Nilai Retry Time for Other Issues harus lebih kecil daripada nilai Retry Time for Failed Connections.
Enable Throttling for Full Data Migration	Selama migrasi penuh, DTS mengonsumsi sumber daya baca dan tulis pada database sumber dan tujuan, yang dapat meningkatkan beban database. Jika diperlukan, Anda dapat mengaktifkan pembatasan kecepatan untuk tugas migrasi penuh. Anda dapat mengatur Queries per second (QPS) to the source database, RPS of Full Data Migration, dan Data migration speed for full migration (MB/s) untuk mengurangi beban pada database tujuan. Catatan Item konfigurasi ini hanya tersedia jika Anda memilih Full Data Migration untuk Migration Types. Anda juga dapat menyesuaikan kecepatan migrasi penuh setelah instans migrasi berjalan.
Only one data type for primary key _id in a table of the data to be synchronized	Dalam data yang akan dimigrasikan, apakah tipe data kunci primer `_id` seragam dalam satu koleksi? Penting Pilih opsi berdasarkan kebutuhan Anda. Jika tidak, kehilangan data dapat terjadi. Parameter ini hanya tersedia jika Anda memilih Full Data Migration untuk Migration Types. Yes: Tipe data unik. Selama migrasi data penuh, DTS tidak memindai tipe data kunci primer di data sumber. Untuk satu koleksi, DTS hanya memigrasikan data yang sesuai dengan satu tipe data kunci primer. No: Tipe data tidak unik. Selama migrasi data penuh, DTS memindai tipe data kunci primer di data sumber dan memigrasikan semua data.
Enable Throttling for Incremental Data Migration	Jika diperlukan, Anda juga dapat memilih untuk mengatur batas kecepatan untuk tugas migrasi inkremental. Anda dapat mengatur RPS of Incremental Data Migration dan Data migration speed for incremental migration (MB/s) untuk mengurangi beban pada database tujuan. Catatan Item konfigurasi ini hanya tersedia jika Anda memilih Incremental Data Migration untuk Migration Types. Anda juga dapat menyesuaikan kecepatan migrasi inkremental setelah instans migrasi berjalan.
Environment Tag	Anda dapat memilih tag lingkungan untuk mengidentifikasi instans. Ini opsional.
Configure ETL	Pilih apakah akan mengaktifkan fitur ekstrak, transformasi, dan 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 Konfigurasikan ETL dalam tugas migrasi data atau sinkronisasi data. No: Menonaktifkan fitur ETL.
Monitoring and Alerting	Pilih apakah akan mengatur peringatan dan menerima pemberitahuan peringatan berdasarkan kebutuhan bisnis Anda. No: Tidak mengatur peringatan. Yes: Konfigurasikan peringatan dengan mengatur ambang batas peringatan dan pemberitahuan peringatan. Jika migrasi gagal atau latensi melebihi ambang batas, sistem akan mengirim pemberitahuan peringatan.

Simpan tugas dan jalankan pemeriksaan awal.
- Untuk melihat parameter konfigurasi instans ini saat memanggil operasi API, arahkan pointer ke tombol Next: Save Task Settings and Precheck dan klik Preview OpenAPI parameters di gelembung yang muncul.
- Jika Anda tidak perlu melihat atau telah selesai melihat parameter API, klik Next: Save Task Settings and Precheck di bagian bawah halaman.
Catatan
- Sebelum tugas migrasi dimulai, DTS melakukan pemeriksaan awal. Tugas hanya dimulai setelah lolos pemeriksaan awal.
- Jika pemeriksaan awal gagal, klik View Details di sebelah item pemeriksaan yang gagal, perbaiki masalah berdasarkan petunjuk, lalu jalankan pemeriksaan awal lagi.
- Jika peringatan dilaporkan selama pemeriksaan awal:
  
  Untuk item pemeriksaan yang tidak dapat diabaikan, klik View Details di sebelah item yang gagal, perbaiki masalah berdasarkan petunjuk, lalu jalankan pemeriksaan awal lagi.
  
  Untuk item pemeriksaan yang dapat diabaikan, Anda dapat mengklik Confirm Alert Details, Ignore, OK, dan Precheck Again untuk melewati item peringatan dan menjalankan pemeriksaan awal lagi. Jika Anda memilih untuk mengabaikan peringatan, hal ini dapat menyebabkan masalah seperti ketidakkonsistenan data dan menimbulkan risiko bagi bisnis Anda.

Beli instans.

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

Di halaman Purchase, pilih spesifikasi link untuk instans migrasi data. Untuk informasi lebih lanjut, lihat tabel berikut.

Kategori	Parameter	Deskripsi
New Instance Class	Resource Group Settings	Pilih kelompok sumber daya tempat instans tersebut berada. Nilai default-nya adalah kelompok sumber daya default. Untuk informasi lebih lanjut, lihat Apa itu Resource Management?
New Instance Class	Instance Class	DTS menyediakan spesifikasi migrasi dengan tingkat kinerja berbeda. Spesifikasi link memengaruhi kecepatan migrasi. Anda dapat memilih spesifikasi berdasarkan skenario bisnis Anda. Untuk informasi lebih lanjut, lihat Spesifikasi link migrasi data.

Setelah konfigurasi selesai, baca dan pilih Data Transmission Service (Pay-as-you-go) Service Terms.
Klik Buy and Start. Di kotak dialog OK yang muncul, klik OK.

Anda dapat melihat progres tugas migrasi di halaman daftar Data Migration Tasks.
Catatan
- Jika tugas migrasi tidak mencakup migrasi inkremental, tugas akan berhenti secara otomatis setelah migrasi penuh selesai. Setelah tugas berhenti, Status-nya berubah menjadi Completed.
- Jika tugas migrasi mencakup migrasi inkremental, tugas tidak berhenti secara otomatis. Tugas migrasi inkremental terus berjalan. Selama tugas migrasi inkremental berjalan, Status tugas adalah Running.

Pemetaan tipe data

Tipe MongoDB	AnalyticDB for MySQL 3.0 tipe
ObjectId	VARCHAR
String	VARCHAR
Document	VARCHAR
DbPointer	VARCHAR
Array	VARCHAR
Date	DATETIME
Timestamp	DATETIME
Double	DOUBLE
32-bit integer (BsonInt32)	INTEGER
64-bit integer (BsonInt64)	BIGINT
Decimal128	DECIMAL
Boolean	BOOLEAN
Null	VARCHAR

Konfigurasi pemetaan

Struktur data MongoDB sumber

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

Skema tabel tujuan AnalyticDB for MySQL

Parameter	Tipe
mongo_id	varchar Catatan Kolom ini adalah kunci primer.
person_name	varchar
person_age	decimal

Kolom baru

Penting

Anda harus menentukan path hierarkis lengkap dalam ekspresi bson_value() untuk mencegah kehilangan data atau kegagalan tugas. Misalnya, jika Anda mengatur ekspresi menjadi bson_value("person"), DTS tidak dapat menyinkronkan data inkremental dari subfield objek person (seperti name, age, dan sex) ke tujuan.

Parameter	Tipe	Pemetaan
mongo_id	STRING	bson_value("_id")
person_name	STRING	bson_value("person","name")
person_age	DECIMAL	bson_value("person","age")