All Products
Search

This Product

    ApsaraDB for MongoDB:Migrasi database MongoDB standalone ke ApsaraDB for MongoDB

    Document Center

    ApsaraDB for MongoDB:Migrasi database MongoDB standalone ke ApsaraDB for MongoDB

    Last Updated:Jul 18, 2026

    Anda dapat menggunakan Data Transmission Service (DTS) untuk memigrasikan data dari database MongoDB mandiri tipe standalone ke instans ApsaraDB for MongoDB.

    Sebagai alternatif, Anda dapat menggunakan alat MongoDB untuk memigrasikan database yang dikelola sendiri ke instans standalone.

    Untuk solusi migrasi dan sinkronisasi data lainnya, lihat Migrasi dan sinkronisasi data.

    Prasyarat

    • Database MongoDB mandiri sumber dan instans ApsaraDB for MongoDB tujuan harus menggunakan versi yang didukung. Untuk informasi selengkapnya, lihat Ikhtisar solusi migrasi.

    • Instans ApsaraDB for MongoDB tujuan harus memiliki ruang penyimpanan setidaknya 10% lebih besar daripada database MongoDB mandiri sumber.

    Catatan penggunaan

    • Database MongoDB mandiri tipe standalone tidak memiliki oplog secara default. Untuk melakukan migrasi data inkremental, konfigurasikan ulang instans sebagai replica set single-node agar oplog diaktifkan.

    • Untuk mencegah gangguan layanan, lakukan migrasi data selama jam sepi.

    • Database config adalah database sistem internal. Jangan memigrasikannya kecuali bisnis Anda memerlukannya.

    • Untuk versi dan mesin penyimpanan yang didukung oleh ApsaraDB for MongoDB, lihat Versi dan mesin penyimpanan. Jika Anda memigrasikan data lintas versi atau mesin penyimpanan yang berbeda, pastikan kompatibilitasnya terlebih dahulu.

    • Anda tidak dapat memigrasikan database admin dan local.

    • DTS menulis data ke instans tujuan secara konkuren, sehingga instans tujuan mungkin menggunakan ruang penyimpanan 5% hingga 10% lebih besar daripada database sumber.

    • Untuk mencegah kehilangan data, pastikan instans tujuan tidak berisi dokumen dengan kunci primer (_id secara default) yang juga ada di sumber.

    Penagihan

    Jenis migrasi

    Biaya konfigurasi link

    Biaya traffic jaringan publik

    Migrasi data penuh

    Gratis

    Migrasi data keluar dari Alibaba Cloud melalui jaringan publik dikenai biaya outbound traffic. Untuk informasi selengkapnya, lihat Ikhtisar penagihan.

    Izin akun database

    Sumber data

    Izin yang diperlukan

    Database MongoDB mandiri sumber

    Izin read untuk database yang akan dimigrasikan.

    Instans ApsaraDB for MongoDB tujuan

    Izin readWrite untuk database tujuan.

    Untuk membuat dan memberikan otorisasi akun database:

    Prosedur

    1. 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 dapat berbeda tergantung pada mode dan tata letak Konsol DMS. Untuk informasi selengkapnya, 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.

    2. Klik Create Task untuk membuka halaman konfigurasi tugas.

    3. Konfigurasikan database sumber dan tujuan.

      Peringatan

      Setelah memilih instans sumber dan tujuan, kami sarankan Anda membaca dengan cermat batasan yang ditampilkan di bagian atas halaman. Jika tidak, tugas dapat gagal atau terjadi ketidakkonsistenan data.

      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 perlu 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 terdaftar, konfigurasikan informasi database secara manual di bawah.

      Database Type

      Pilih NoSQL database > MongoDB.

      Access Method

      Pilih lokasi penerapan database sumber. Topik ini menggunakan Public IP Address sebagai contoh.

      Catatan

      Jika Anda memilih metode akses lain untuk database mandiri Anda, Anda harus menyelesaikan langkah persiapan tambahan.

      Instance Region

      Pilih wilayah tempat database MongoDB mandiri Anda berada.

      Catatan

      Jika wilayah tersebut tidak tercantum, pilih wilayah yang paling dekat secara geografis.

      Architecture

      Pilih Replica Set.

      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 mandiri maupun instans ApsaraDB for MongoDB. Metode ini menawarkan latensi lebih rendah untuk migrasi data inkremental karena log ditarik 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 (klaster non-elastis), Anda hanya dapat memilih ChangeStream.

        • Jika Anda mengatur Architecture menjadi Sharded Cluster untuk database sumber, Anda tidak perlu memasukkan Shard account atau Shard password.

      Endpoint Type

      Pilih Standalone.

      Catatan

      Pengaturan ini hanya tersedia untuk instans MongoDB mandiri yang diakses melalui Express Connect, VPN Gateway, or Smart Access Gateway, Public IP Address, atau Cloud Enterprise Network (CEN).

      Domain Name or IP

      Masukkan nama domain atau alamat IP database MongoDB mandiri. Dalam contoh ini, digunakan alamat IP publik.

      Port Number

      Masukkan port layanan database MongoDB mandiri.

      Authentication Database

      Masukkan nama database autentikasi. Nilai default-nya adalah admin.

      Database Account

      Masukkan akun untuk database MongoDB mandiri. Untuk persyaratan izin, lihat Izin akun database.

      Catatan

      Jika Access Method untuk MongoDB yang di-host sendiri Anda adalah Self-managed Database on ECS atau Database Gateway, masukkan akun node Shard.

      Database Password

      Masukkan password untuk akun database.

      Encryption

      DTS mendukung tiga metode koneksi: Non-encrypted, SSL-encrypted, dan Mongo Atlas SSL. Opsi untuk Encryption bervariasi tergantung pada 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 mandiri (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 terdaftar, konfigurasikan informasi database secara manual di bawah.

      Database Type

      Pilih MongoDB.

      Access Method

      Pilih Alibaba Cloud Instance.

      Instance Region

      Pilih wilayah tempat instans ApsaraDB for MongoDB tujuan berada.

      Replicate Data Across Alibaba Cloud Accounts

      Dalam contoh ini, digunakan instans database di bawah Akun Alibaba Cloud saat ini. Pilih No.

      Architecture

      Pilih jenis arsitektur instans ApsaraDB for MongoDB tujuan.

      Instance ID

      Pilih ID instans ApsaraDB for MongoDB tujuan.

      Authentication Database

      Masukkan nama database tempat akun instans ApsaraDB for MongoDB tujuan didefinisikan. Jika Anda belum mengubahnya, nilai default-nya adalah admin.

      Database Name

      Masukkan nama database di instans ApsaraDB for MongoDB tujuan yang akan menyimpan objek yang dimigrasikan.

      Database Account

      Masukkan akun database untuk instans ApsaraDB for MongoDB tujuan. Untuk persyaratan izin, lihat Izin akun database.

      Database Password

      Masukkan password untuk akun database.

      Encryption

      DTS mendukung tiga metode koneksi: Non-encrypted, SSL-encrypted, dan Mongo Atlas SSL. Opsi untuk Encryption bervariasi tergantung pada Access Method dan Architecture yang dipilih. Opsi yang ditampilkan di konsol berlaku.

      Catatan

      • Database MongoDB dengan Architecture Sharded Cluster tidak mendukung SSL-encrypted.

      • Jika tujuan adalah database MongoDB mandiri (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.

    4. Setelah menyelesaikan konfigurasi, klik Test Connectivity and Proceed di bagian bawah halaman. Di kotak dialog CIDR Blocks of DTS Servers yang muncul, klik Test Connectivity.

      Catatan

      Pastikan segmen alamat IP layanan DTS telah ditambahkan secara otomatis atau manual ke pengaturan keamanan database sumber dan tujuan agar mengizinkan akses dari server DTS. Untuk informasi selengkapnya, lihat Tambahkan alamat IP server DTS ke daftar putih.

    5. Konfigurasikan objek tugas.

      1. Di halaman Configure Objects, konfigurasikan objek yang ingin dimigrasikan.

        Parameter

        Deskripsi

        Migration Types

        Pilih kedua opsi Schema Migration dan Full Data Migration.

        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 selengkapnya, lihat Object name mapping.

        • Ignore Errors and Proceed: Melewati pemeriksaan 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 tetap dipertahankan. Catatan dari database sumber tidak dimigrasikan ke database tujuan.

          • Inisialisasi data dapat gagal, hanya sebagian data yang dimigrasikan, atau migrasi gagal.

        Capitalization of Object Names in Destination Instance

        Anda dapat mengonfigurasi kebijakan sensitivitas huruf besar/kecil untuk nama objek yang dimigrasikan, seperti database dan koleksi, di instans tujuan. Secara default, DTS default policy dipilih. Anda juga dapat memilih untuk menjaga sensitivitas huruf besar/kecil konsisten dengan kebijakan default database sumber atau tujuan. Untuk informasi selengkapnya, lihat Case sensitivity of object names in the destination database.

        Source Objects

        Di kotak Source Objects, klik objek yang ingin dimigrasikan, lalu klik Right arrow untuk memindahkannya ke kotak Selected Objects.

        Catatan

        Anda dapat memilih objek pada tingkat database atau koleksi.

        Selected Objects

        • Untuk mengatur nama objek migrasi di instans tujuan, atau menentukan objek yang menerima data di instans tujuan, klik kanan objek migrasi di kotak Selected Objects untuk melakukan perubahan. Untuk informasi selengkapnya, lihat Object name mapping.

        • Untuk menghapus objek migrasi yang dipilih, klik objek di kotak Selected Objects, lalu klik image untuk memindahkannya ke kotak Source Objects.

        Catatan

        • Untuk memfilter data, klik kanan koleksi di kotak Selected Objects dan konfigurasikan kondisi filter di kotak dialog yang muncul. Untuk detailnya, lihat Configure filter conditions.

        • Jika Anda menggunakan pemetaan nama objek untuk menentukan database atau koleksi tujuan yang berbeda, objek lain yang bergantung pada objek asli mungkin gagal dimigrasikan.

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

        Parameter

        Deskripsi

        Dedicated Cluster for Task Scheduling

        Tugas DTS berjalan di kluster bersama secara default. Untuk menggunakan resource khusus, beli kluster khusus. Untuk informasi selengkapnya, lihat What is a DTS dedicated cluster?.

        Retry Time for Failed Connections

        Setelah tugas migrasi dimulai, jika koneksi ke database sumber atau tujuan gagal, DTS melaporkan kesalahan dan segera mulai mencoba koneksi ulang. Durasi percobaan ulang default adalah 720 menit. Anda dapat menyesuaikan waktu percobaan ulang ke nilai antara 10 hingga 1.440 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 selama periode percobaan ulang koneksi, kami menyarankan Anda menyesuaikan waktu percobaan ulang sesuai kebutuhan bisnis, 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 operasi ulang. Durasi percobaan ulang default adalah 10 menit. Anda dapat menyesuaikan waktu percobaan ulang ke nilai antara 1 hingga 1.440 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 resource baca dan tulis di 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 di 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 bersifat 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.

        Environment Tag

        Opsional. Pilih tag lingkungan untuk mengidentifikasi instans.

        Configure ETL

        Pilih apakah akan mengaktifkan fitur ekstrak, transformasi, dan muat (ETL). Untuk informasi selengkapnya, lihat What is ETL? Nilai yang valid:

        Monitoring and Alerting

        Pilih apakah akan mengatur peringatan dan menerima pemberitahuan peringatan sesuai kebutuhan bisnis Anda.

        • No: Tidak mengatur peringatan.

        • Yes: Konfigurasikan peringatan dengan mengatur alert threshold dan alert notifications. Jika migrasi gagal atau latensi melebihi ambang batas, sistem akan mengirim pemberitahuan peringatan.

      3. Klik Next: Data Verification untuk mengonfigurasi tugas verifikasi data.

        Untuk informasi selengkapnya tentang fitur verifikasi data, lihat Configure data validation.

    6. 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.

    7. Beli instans.

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

      2. Di halaman Purchase, pilih spesifikasi link untuk instans migrasi data. Untuk informasi selengkapnya, 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 selengkapnya, lihat What is Resource Management?

        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 selengkapnya, lihat Data migration link specifications.

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

      4. Klik Buy and Start, dan di kotak dialog OK, klik Confirm.

        Anda dapat memantau kemajuan tugas migrasi di halaman Data Migration Tasks.