All Products
Search
Document Center

ApsaraDB for MongoDB:Migrasi data dari database MongoDB Atlas ke ApsaraDB for MongoDB

Last Updated:Mar 28, 2026

Panduan ini memandu Anda melalui proses migrasi data dari database MongoDB Atlas ke instans ApsaraDB for MongoDB menggunakan Data Transmission Service (DTS). DTS mendukung migrasi data penuh dan migrasi data inkremental. Memilih kedua jenis tersebut menjaga layanan Anda tetap online selama migrasi.

Dalam panduan ini, Anda akan:

  • Menambahkan alamat IP server DTS ke daftar putih MongoDB Atlas

  • Mengonfigurasi koneksi database sumber dan tujuan di DTS

  • Memilih jenis dan objek migrasi

  • Menjalankan pemeriksaan awal dan membeli instans DTS

  • Beralih beban kerja ke ApsaraDB for MongoDB

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

  • Instans ApsaraDB for MongoDB dengan kapasitas penyimpanan yang tersedia minimal 10% lebih besar daripada ukuran total data di database sumber MongoDB Atlas (disarankan)

  • Akun database MongoDB Atlas dengan izin yang diperlukan (lihat Izin yang diperlukan)

  • Akun database ApsaraDB for MongoDB dengan izin baca dan tulis pada database tujuan

Batasan

  • DTS membaca dari sumber dan menulis ke tujuan secara bersamaan selama migrasi data penuh, sehingga meningkatkan beban pada kedua server database. Lakukan migrasi data pada jam sepi untuk meminimalkan dampak.

  • DTS tidak dapat memigrasikan data dari database admin atau local. Database config merupakan database internal; migrasi database ini tidak disarankan.

  • Jika database MongoDB sumber dan tujuan menggunakan versi atau mesin penyimpanan yang berbeda, pastikan aplikasi Anda dapat berjalan di keduanya. Untuk informasi versi dan mesin penyimpanan yang didukung, lihat Versi dan mesin penyimpanan MongoDB.

  • Penulisan bersamaan ke database tujuan menyebabkan ukuran penyimpanan tujuan menjadi 5%–10% lebih besar daripada ukuran data sumber.

  • Instans ApsaraDB for MongoDB tujuan tidak boleh berisi dokumen dengan kunci primer _id yang sama dengan dokumen di sumber. Jika tidak, data dapat hilang. Jika terdapat konflik, hapus dokumen yang sesuai dari tujuan sebelum memulai migrasi tanpa mengganggu bisnis Anda.

Penagihan

Jenis migrasiBiaya konfigurasi instansBiaya traffic Internet
Migrasi data penuhGratisDikenakan hanya jika data dimigrasikan dari Alibaba Cloud melalui Internet. Untuk detailnya, lihat Ikhtisar penagihan.
Migrasi data inkrementalDikenakan biaya. Untuk detailnya, lihat Ikhtisar penagihan.

Jenis migrasi

Jenis migrasiDeskripsiObjek yang didukung
Migrasi data penuhMemigrasikan data yang ada dari database MongoDB sumber ke tujuan.Database, koleksi, dan indeks
Migrasi data inkrementalSetelah migrasi data penuh selesai, secara terus-menerus mereplikasi perubahan dari sumber ke tujuan. Mendukung operasi pembuatan dan penghapusan pada database, koleksi, dan indeks, serta operasi pembuatan, penghapusan, dan pembaruan pada dokumen.Database, koleksi, indeks, dan dokumen

Izin yang diperlukan

DatabaseMigrasi data penuhMigrasi data inkremental
Database sumber MongoDB AtlasIzin baca pada database sumber dan izin listDatabasesIzin baca pada database sumber, admin, dan local, serta izin listDatabases
Instans tujuan ApsaraDB for MongoDBIzin baca dan tulis pada database tujuanIzin baca dan tulis pada database tujuan

Untuk informasi cara membuat akun database dan memberikan izin yang diperlukan di MongoDB Atlas, lihat db.createUser().

Untuk instans tujuan ApsaraDB for MongoDB, lihat Gunakan DMS untuk mengelola akun database.

Tambahkan alamat IP server DTS ke daftar putih MongoDB Atlas

DTS memerlukan akses jaringan ke database MongoDB Atlas Anda. Selesaikan langkah ini sebelum mengonfigurasi tugas migrasi.

  1. Login ke konsol MongoDB Atlas.

  2. Di panel navigasi kiri, klik Network Access.

  3. Pada tab IP Whitelist, klik ADD IP ADDRESS.

  4. Tambahkan alamat IP server DTS untuk wilayah tempat database MongoDB Atlas sumber berada. Untuk rentang alamat IP DTS, lihat Tambahkan blok CIDR server DTS. Untuk instruksi MongoDB Atlas, lihat Add IP Access List Entries.

Penting

Hapus aturan keamanan ini setelah migrasi selesai untuk mengurangi risiko keamanan.

Konfigurasi tugas migrasi (konsol DTS baru)

Langkah 1: Buka halaman Data Migration

Gunakan salah satu metode berikut:

Konsol DTS

  1. Login ke Konsol DTS.

  2. Di panel navigasi kiri, klik Data Migration.

  3. Di pojok kiri atas, pilih wilayah tempat instans migrasi data berada.

Konsol DMS

Navigasi aktual dapat berbeda tergantung mode dan tata letak konsol DMS. Untuk detailnya, lihat Simple mode dan Customize the layout and style of the DMS console.
  1. Login ke Konsol DMS.

  2. Di bilah navigasi atas, arahkan kursor ke Data + AI > DTS (DTS) > Data Migration.

  3. Dari daftar drop-down di sebelah kanan Migration Tasks, pilih wilayah tempat instans migrasi data berada.

Langkah 2: Konfigurasi database sumber dan tujuan

  1. Klik Create Task.

  2. Baca Limits yang ditampilkan di bagian atas halaman sebelum melanjutkan. Mengabaikan batasan ini dapat menyebabkan kegagalan tugas atau inkonsistensi data.

  3. Konfigurasikan database sumber dan tujuan menggunakan parameter berikut.

Database sumber (MongoDB Atlas)

ParameterDeskripsi
Task NameNama untuk tugas DTS. DTS menghasilkan nama secara otomatis. Tentukan nama deskriptif agar mudah diidentifikasi. Nama tidak harus unik.
Select a DMS database instancePilih instans database yang sudah ada untuk mengisi parameter secara otomatis, atau konfigurasi koneksi secara manual. Untuk mendaftarkan instans baru, klik Add DMS Database Instance. Untuk detailnya, lihat Register an Alibaba Cloud database instance dan Register a database hosted on a third-party cloud service or a self-managed database.
Database TypePilih MongoDB.
Access MethodPilih Public IP Address.
Instance RegionWilayah tempat database MongoDB Atlas berada. Jika wilayah tidak tercantum, pilih wilayah terdekat secara geografis.
ArchitecturePilih Replica Set.
Domain Name or IPTitik akhir node PRIMARY di database MongoDB Atlas. Dapatkan titik akhir ini dari konsol MongoDB Atlas.
Port NumberPort layanan database MongoDB Atlas. Default: 27017.
Authentication DatabaseDatabase autentikasi tempat akun database dibuat.
Database AccountAkun MongoDB Atlas. Untuk izin yang diperlukan, lihat Izin yang diperlukan.
Database PasswordKata sandi untuk akun database.
EncryptionPilih Mongo Atlas SSL.

Database tujuan (ApsaraDB for MongoDB)

ParameterDeskripsi
Select a DMS database instancePilih instans database yang sudah ada untuk mengisi parameter secara otomatis, atau konfigurasi koneksi secara manual.
Database TypePilih MongoDB.
Access MethodPilih Alibaba Cloud Instance.
Instance RegionWilayah tempat instans ApsaraDB for MongoDB tujuan berada.
ArchitectureArsitektur instans tujuan: Replica Set atau Sharded Cluster. Untuk detailnya, lihat Replica set instances dan Sharded cluster instances.
Instance IDID instans ApsaraDB for MongoDB tujuan.
Authentication DatabaseDatabase autentikasi tempat akun database dibuat. Masukkan admin untuk menggunakan akun root.
Database AccountAkun ApsaraDB for MongoDB. Untuk izin yang diperlukan, lihat Izin yang diperlukan.
Database PasswordKata sandi untuk akun database.

Langkah 3: Uji konektivitas

Di bagian bawah halaman, klik Test Connectivity and Proceed, lalu klik Test Connectivity di kotak dialog CIDR Blocks of DTS Servers.

Blok CIDR server DTS harus ditambahkan ke pengaturan keamanan database sumber dan tujuan. Untuk detailnya, lihat Tambahkan blok CIDR server DTS.

Langkah 4: Konfigurasi objek migrasi

Pada halaman Configure Objects, atur parameter berikut.

ParameterDeskripsi
Migration TypesPilih Schema Migration + Full Data Migration untuk migrasi satu kali. Pilih Schema Migration + Full Data Migration + Incremental Data Migration untuk menjaga layanan tetap online selama migrasi. Jika Anda melewatkan Schema Migration, buat database dan koleksi tujuan secara manual sebelum memulai. Jika Anda melewatkan Incremental Data Migration, hentikan penulisan ke database sumber selama migrasi untuk menjaga konsistensi data.
Processing Mode of Conflicting TablesPrecheck and Report Errors: memeriksa konflik nama koleksi sebelum migrasi dimulai. Tugas gagal jika ditemukan konflik. Gunakan pemetaan nama objek untuk menyelesaikan konflik. Ignore Errors and Proceed: melewati pemeriksaan konflik. Gunakan opsi ini hanya jika Anda menerima risiko inkonsistensi data — DTS melewati catatan dengan kunci primer yang bertabrakan dan tidak menimpa data tujuan.
Capitalization of Object Names in Destination InstanceMengontrol kapitalisasi nama database dan koleksi di tujuan. Default: Kebijakan default DTS. Untuk detailnya, lihat Specify the capitalization of object names in the destination instance.
Source ObjectsPilih satu atau beberapa database atau koleksi dari Source Objects dan klik ikon panah untuk memindahkannya ke Selected Objects.
Selected ObjectsUntuk mengganti nama satu objek, klik kanan objek tersebut di Selected Objects. Untuk detailnya, lihat Map the name of a single object. Untuk mengganti nama beberapa objek sekaligus, klik Batch Edit. Untuk detailnya, lihat Map multiple object names at a time. Perhatikan bahwa mengganti nama objek dapat menyebabkan objek dependen gagal dimigrasikan.

Klik Next: Advanced Settings.

Langkah 5: Konfigurasi pengaturan lanjutan

ParameterDeskripsi
Retry Time for Failed ConnectionsDurasi DTS mencoba kembali setelah kegagalan koneksi. Nilai valid: 10–1.440 menit. Default: 720 menit. Atur minimal 30 menit. Jika DTS terhubung kembali dalam jendela ini, tugas dilanjutkan secara otomatis. Perhatikan bahwa waktu percobaan ulang dikenai biaya.
Retry Time for Other IssuesDurasi DTS mencoba kembali setelah kegagalan operasi DDL atau DML. Nilai valid: 1–1.440 menit. Default: 10 menit. Atur lebih dari 10 menit. Harus kurang dari Retry Time for Failed Connections.
Enable Throttling for Full Data MigrationMembatasi beban baca dan tulis pada database selama migrasi data penuh. Konfigurasikan Queries per second (QPS) to the source database, Full Data Migration, dan Kecepatan migrasi data untuk migrasi penuh (MB/detik). Opsi ini hanya tersedia saat Full Data Migration dipilih.
Enable Throttling for Incremental Data MigrationMembatasi beban selama migrasi data inkremental. Konfigurasikan Incremental Data Migration dan Data migration speed for incremental migration (MB/s). Tersedia hanya jika Incremental Data Migration dipilih.
Environment TagTag opsional untuk mengidentifikasi instans DTS.
Configure ETLMengaktifkan fitur ekstrak, transformasi, dan muat (ETL). Pilih Yes untuk memasukkan pernyataan pemrosesan data di editor kode. Untuk detailnya, lihat Configure ETL in a data migration or data synchronization task.
Monitoring and AlertingMengonfigurasi peringatan untuk kegagalan tugas atau latensi yang melebihi ambang batas. Pilih Yes untuk mengatur ambang batas peringatan dan kontak notifikasi. Untuk detailnya, lihat Configure monitoring and alerting.

Klik Next Step: Data Verification untuk mengonfigurasi tugas verifikasi data. Untuk detailnya, lihat Configure a data verification task.

Langkah 6: Jalankan pemeriksaan awal

Klik Next: Save Task Settings and Precheck.

Untuk melihat pratinjau parameter OpenAPI untuk tugas ini sebelum menyimpan, arahkan kursor ke Next: Save Task Settings and Precheck dan klik Preview OpenAPI parameters.

DTS menjalankan pemeriksaan awal sebelum tugas dapat dimulai. Jika pemeriksaan awal gagal:

  • Klik View Details di sebelah item yang gagal untuk melihat penyebabnya, perbaiki masalah tersebut, lalu klik Precheck Again.

  • Jika item peringatan dapat diabaikan, klik Confirm Alert Details > Ignore > OK > Precheck Again. Mengabaikan peringatan dapat menyebabkan inkonsistensi data.

Langkah 7: Beli instans DTS dan mulai tugas

  1. Tunggu hingga Success Rate mencapai 100%, lalu klik Next: Purchase Instance.

  2. Pada halaman Purchase Instance, konfigurasikan parameter berikut.

    ParameterDeskripsi
    Resource GroupKelompok sumber daya untuk instans DTS. Default: default resource group. Untuk detailnya, lihat What is Resource Management?
    Instance ClassKelas instans menentukan kecepatan migrasi. Pilih kelas berdasarkan volume data dan kebutuhan waktu Anda. Untuk detailnya, lihat Instance classes of data migration instances.
  3. Baca dan centang kotak untuk menyetujui Data Transmission Service (Pay-As-You-Go) Service Terms.

  4. Klik Buy and Start, lalu klik OK.

Lacak progres tugas di halaman Data Migration.

Konfigurasi tugas migrasi (konsol DTS lama)

Jika Anda menggunakan Konsol DTS baru, ikuti Konfigurasi tugas migrasi (DTS console) sebagai gantinya.
  1. Beli instans migrasi data. Untuk detailnya, lihat Purchase a DTS instance.

  2. Login ke Konsol DTS.

    Jika Anda dialihkan ke konsol Data Management Service (DMS), klik ikon old di image untuk beralih ke versi sebelumnya konsol DTS.
  3. Di panel navigasi kiri, klik Data Migration.

  4. Di bagian atas halaman Migration Tasks, pilih wilayah tempat instans ApsaraDB for MongoDB berada.

  5. Temukan instans migrasi data dan klik Configure Migration Task.

  6. Konfigurasikan database sumber dan tujuan.

    Database sumber

    ParameterDeskripsi
    Task NameNama tugas. DTS menghasilkan nama secara otomatis. Tentukan nama deskriptif agar mudah diidentifikasi.
    Instance TypePilih User-Created Database with Public IP Address.
    Instance RegionTidak diperlukan jika Instance Type adalah User-Created Database with Public IP Address.
    Database TypePilih MongoDB.
    Hostname or IP AddressTitik akhir node PRIMARY di database MongoDB Atlas. Animasi berikut menunjukkan cara mendapatkan titik akhir tersebut. 获取Atlas地址
    Port NumberPort layanan database MongoDB Atlas. Default: 27017.
    Database NameDatabase autentikasi tempat akun database dibuat.
    Database AccountAkun MongoDB Atlas. Untuk izin yang diperlukan, lihat Izin yang diperlukan.
    Database PasswordKata sandi untuk akun database. Setelah memasukkan kata sandi, klik Test Connectivity untuk memverifikasi. Pesan Passed menunjukkan koneksi berhasil.
    EncryptionPilih SSL-encrypted.

    Database tujuan

    ParameterDeskripsi
    Instance TypePilih MongoDB Instance.
    Instance RegionWilayah tempat instans ApsaraDB for MongoDB berada.
    MongoDB Instance IDID instans ApsaraDB for MongoDB.
    Database NameDatabase autentikasi tempat akun database dibuat. Masukkan admin untuk menggunakan akun root.
    Database AccountAkun ApsaraDB for MongoDB. Untuk izin yang diperlukan, lihat Izin yang diperlukan.
    Database PasswordKata sandi untuk akun database. Setelah memasukkan kata sandi, klik Test Connectivity untuk memverifikasi.

    设置源和目标库信息

  7. Klik Set Whitelist and Next. DTS secara otomatis menambahkan blok CIDR servernya ke daftar putih alamat IP instans database Alibaba Cloud. Untuk database yang dikelola sendiri yang dihosting di instans Elastic Compute Service (ECS), DTS menambahkan blok CIDR ke aturan security group ECS. Untuk database yang dideploy di pusat data atau cloud pihak ketiga, tambahkan blok CIDR DTS secara manual. Untuk detailnya, lihat Tambahkan blok CIDR server DTS.

    Peringatan

    Menambahkan blok CIDR DTS ke daftar putih Anda membuka akses jaringan database Anda ke server DTS. Sebelum melanjutkan, tinjau implikasi keamanan dan ambil langkah pencegahan: gunakan kredensial kuat, batasi port yang terbuka, autentikasi panggilan API, audit aturan daftar putih secara berkala, dan segera hapus blok CIDR yang tidak sah. Untuk konektivitas privat, gunakan Express Connect, VPN Gateway, atau Smart Access Gateway.

  8. Pilih jenis dan objek migrasi.

    PengaturanDeskripsi
    Migration typesPilih Full Data Migration untuk migrasi satu kali. Pilih Full Data Migration + Incremental Data Migration untuk menjaga layanan tetap online selama migrasi. Jika Anda melewatkan Incremental Data Migration, hentikan penulisan ke database sumber selama migrasi untuk menjaga konsistensi data.
    Objects to migrateDi bagian Available, pilih database atau koleksi, lalu klik ikon panah untuk memindahkannya ke Selected. DTS tidak dapat memigrasikan database admin, local, atau config. Objek dapat berupa database, koleksi, atau fungsi. Untuk mengganti nama objek di tujuan, gunakan fitur pemetaan nama objek. Untuk detailnya, lihat Object name mapping.
    Retry time for failed connectionsDurasi DTS mencoba kembali setelah kegagalan koneksi. Default: 12 jam. Jika DTS terhubung kembali dalam jendela ini, tugas dilanjutkan. Perhatikan bahwa waktu percobaan ulang dikenai biaya.
  9. Klik Precheck.

    DTS menjalankan pemeriksaan awal sebelum tugas dapat dimulai. Jika pemeriksaan awal gagal, klik ikon info di sebelah item yang gagal untuk melihat penyebabnya. Perbaiki masalah tersebut dan klik Precheck lagi. Anda juga dapat mengabaikan item yang gagal non-kritis dan menjalankan kembali pemeriksaan awal.
  10. Setelah pemeriksaan awal berhasil, klik Next.

  11. Di kotak dialog Confirm Settings, konfigurasikan Instance Class dan centang kotak untuk menyetujui Data Transmission Service (Pay-As-You-Go) Service Terms.

  12. Klik Buy and Start.

Pantau dan hentikan migrasi

Migrasi data penuh

Jangan hentikan tugas migrasi data penuh secara manual. Tunggu hingga tugas berhenti secara otomatis. Menghentikannya lebih awal dapat menyebabkan database tujuan tidak lengkap.

Migrasi data inkremental

Migrasi data inkremental tidak berhenti secara otomatis. Hentikan secara manual saat siap melakukan cut over.

Untuk menghentikan migrasi inkremental secara bersih:

  1. Tunggu hingga bilah progres tugas menampilkan Incremental Data Migration dan Tugas migrasi data tidak tertunda.

  2. Hentikan penulisan ke database sumber dan tunggu beberapa menit.

  3. Tunggu hingga status Incremental Data Migration berubah menjadi Tugas migrasi tidak tertunda lagi.

  4. Hentikan tugas migrasi secara manual.

    增量迁移无延迟

Hentikan migrasi pada jam sepi atau tepat sebelum beralih beban kerja ke ApsaraDB for MongoDB.

Langkah selanjutnya

Setelah menghentikan tugas migrasi, alihkan beban kerja Anda ke instans ApsaraDB for MongoDB tujuan.