全部产品
Search

搜索本产品

    ApsaraDB for MongoDB：Migrasikan database MongoDB mandiri ke ApsaraDB for MongoDB menggunakan DTS

    文档中心

    ApsaraDB for MongoDB：Migrasikan database MongoDB mandiri ke ApsaraDB for MongoDB menggunakan DTS

    更新时间：Nov 10, 2025

    Topik ini menjelaskan cara menggunakan Data Transmission Service (DTS) untuk memigrasikan database MongoDB yang dikelola sendiri dengan arsitektur standalone ke ApsaraDB for MongoDB.

    Anda juga dapat menggunakan alat MongoDB untuk memigrasikan database yang dikelola sendiri ke instans mandiri. Untuk informasi lebih lanjut, lihat Migrate a self-managed database to a standalone instance using MongoDB tools.

    Untuk informasi lebih lanjut tentang solusi migrasi atau sinkronisasi data, lihat Data migration and synchronization.

    Persiapan

    • Untuk informasi tentang versi yang didukung oleh database MongoDB yang dikelola sendiri dan ApsaraDB for MongoDB, lihat Ikhtisar solusi migrasi.

    • Pastikan ruang penyimpanan instans ApsaraDB for MongoDB minimal 10% lebih besar daripada ruang penyimpanan yang digunakan oleh database MongoDB yang dikelola sendiri.

    Catatan penggunaan

    • Secara default, database MongoDB yang dikelola sendiri dengan arsitektur mandiri tidak mendukung oplog. Untuk melakukan migrasi inkremental menggunakan DTS, Anda harus mengaktifkan oplog dengan mengonfigurasi instans mandiri sebagai set replika satu node.

    • Untuk menghindari dampak terhadap layanan Anda, lakukan migrasi data di luar jam sibuk.

    • Database config adalah database sistem internal. Jangan migrasikan database ini kecuali benar-benar diperlukan.

    • Untuk informasi tentang versi dan mesin penyimpanan yang didukung oleh instans ApsaraDB for MongoDB, lihat Versi dan mesin penyimpanan. Sebelum memigrasikan data antarversi atau antarmesin penyimpanan, pastikan kompatibilitasnya terlebih dahulu.

    • Database admin dan local tidak dapat digunakan sebagai database sumber atau tujuan.

    • DTS menulis data secara bersamaan. Akibatnya, database tujuan mungkin menggunakan ruang penyimpanan 5% hingga 10% lebih banyak daripada database sumber.

    • Pastikan instans MongoDB tujuan tidak berisi dokumen dengan kunci utama (_id) yang sama dengan database sumber. Jika tidak, risiko kehilangan data dapat terjadi. Jika instans tujuan memiliki dokumen dengan kunci utama yang sama dengan sumber, hapus dokumen yang bertentangan dari instans tujuan sebelum memulai migrasi.

    Penagihan

    Jenis migrasi

    Biaya Konfigurasi Tautan

    Biaya transfer data

    Migrasi data penuh

    Gratis

    Anda akan dikenakan biaya saat mentransfer data keluar dari Alibaba Cloud melalui Internet. Untuk informasi lebih lanjut, lihat Ikhtisar Penagihan.

    Izin yang diperlukan untuk akun database

    Migrasi Sumber Data

    Migrasi data penuh

    Database MongoDB yang dikelola sendiri

    izin baca pada database yang akan dimigrasikan

    Database ApsaraDB for MongoDB

    izin readWrite pada database tujuan

    Untuk membuat akun database dan memberikan izin:

    Prosedur

    1. Gunakan salah satu metode berikut untuk membuka halaman Migrasi Data dan pilih wilayah tempat instansi migrasi data berada.

      Konsol DTS

      1. Masuk ke Konsol DTS.

      2. Di panel navigasi sisi kiri, klik Data Migration.

      3. Di sudut kiri atas halaman, pilih wilayah tempat instansi migrasi data berada.

      Konsol DMS

      Catatan

      Operasi sebenarnya dapat bervariasi tergantung pada mode dan tata letak Konsol DMS. Untuk informasi lebih lanjut, lihat Mode Sederhana dan Sesuaikan Tata Letak dan Gaya Konsol DMS.

      1. Masuk ke Konsol DMS.

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

      3. Dari daftar drop-down di sebelah kanan Data Migration Tasks, pilih wilayah tempat instansi sinkronisasi data berada.

    2. Klik Create Task untuk membuka halaman konfigurasi tugas.

    3. Konfigurasikan database sumber dan tujuan. Tabel berikut menjelaskan parameter tersebut.

      Peringatan

      Setelah mengonfigurasi database sumber dan tujuan, disarankan untuk membaca bagian Limits yang ditampilkan di bagian atas halaman. Jika tidak, tugas mungkin gagal atau menyebabkan inkonsistensi data.

      Kategori

      Konfigurasi

      Deskripsi

      Tidak Ada

      Task Name

      Nama dari tugas DTS. DTS secara otomatis menghasilkan nama tugas. Kami sarankan Anda menentukan nama informatif yang memudahkan identifikasi tugas. Anda tidak perlu menentukan nama tugas yang unik.

      Source Database

      Select Existing Connection

      • Jika Anda menggunakan instansiasi database yang terdaftar dengan DTS, pilih instansinya dari daftar drop-down. DTS secara otomatis mengisi parameter-parameter database berikut untuk instansi tersebut. Untuk informasi lebih lanjut, lihat Kelola koneksi database.

        Catatan

        Di Konsol DMS, Anda bisa memilih instansiasi database dari daftar drop-down Select a DMS database instance.

      • Jika Anda gagal mendaftarkan instansi dengan DTS, atau Anda tidak perlu menggunakan instansi yang terdaftar dengan DTS, Anda harus mengonfigurasi informasi database berikut.

      Database Type

      Pilih NoSQL Database > MongoDB.

      Access Method

      Pilih jenis berdasarkan lokasi penyebaran database sumber. Topik ini menggunakan Public IP Address sebagai contoh.

      Catatan

      Jika Anda memilih jenis koneksi lain untuk database yang dikelola sendiri, Anda juga harus melakukan persiapan yang sesuai persiapan.

      Instance Region

      Pilih wilayah tempat database MongoDB yang dikelola sendiri berada.

      Catatan

      Jika wilayah database MongoDB yang dikelola sendiri Anda tidak terdaftar, Anda bisa memilih wilayah yang secara geografis paling dekat dengannya.

      Architecture

      Pilih Replica Set.

      Migration Method

      Metode yang digunakan untuk memigrasikan data inkremental dari database sumber. Pilih metode berdasarkan kebutuhan bisnis Anda. Nilai valid:

      • Oplog (direkomendasikan):

        Opsi ini tersedia jika fitur oplog diaktifkan untuk database sumber.

        Catatan

        Secara default, fitur oplog diaktifkan baik untuk database MongoDB yang dikelola sendiri maupun ApsaraDB for MongoDB instansiasi. Fitur ini memungkinkan Anda memigrasikan data inkremental dengan latensi rendah karena kecepatan penarikan log yang cepat. Oleh karena itu, kami merekomendasikan Anda memilih Oplog untuk parameter Metode Migrasi.

      • ChangeStream: Opsi ini tersedia jika aliran perubahan diaktifkan untuk database sumber. Untuk informasi lebih lanjut, lihat Change Streams.

        Catatan

        • Jika database sumber adalah klaster Amazon DocumentDB inelastis, Anda hanya dapat mengatur parameter Metode Migrasi ke ChangeStream.

        • Jika Anda memilih Sharded Cluster untuk parameter Architecture, Anda tidak perlu mengonfigurasi parameter Shard account dan Shard password.

      Endpoint Type

      Pilih Standalone.

      Catatan

      Konfigurasi item ini hanya muncul saat Anda terhubung ke database MongoDB yang dikelola sendiri menggunakan 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 dari database MongoDB yang dikelola sendiri. Dalam contoh ini, masukkan alamat IP publik.

      Port Number

      Masukkan port layanan dari database MongoDB yang dikelola sendiri.

      Authentication Database

      Masukkan nama database tempat akun database milik dalam database MongoDB yang dikelola sendiri. Defaultnya adalah admin jika belum diubah.

      Database Account

      Masukkan akun untuk node Mongos dari database MongoDB yang dikelola sendiri. Untuk persyaratan izin, lihat Izin yang diperlukan untuk akun database.

      Catatan

      Jika parameter Access Method untuk database MongoDB yang dikelola sendiri adalah Self-managed Database on ECS atau Database Gateway, masukkan akun untuk node shard.

      Database Password

      Kata sandi yang digunakan untuk mengakses instansiasi database.

      Encryption

      Menentukan apakah akan mengenkripsi koneksi ke database sumber. Anda bisa memilih Non-encrypted, SSL-encrypted, atau Mongo Atlas SSL berdasarkan kebutuhan bisnis Anda. Opsi yang tersedia untuk parameter Encryption ditentukan oleh nilai yang dipilih untuk parameter Access Method dan Architecture. Opsi yang ditampilkan di Konsol DTS berlaku.

      Catatan

      • Jika parameter Architecture diatur ke Sharded Cluster, dan parameter Migration Method diatur ke Oplog untuk database ApsaraDB for MongoDB, parameter Enkripsi SSL-encrypted tidak tersedia.

      • Jika database sumber adalah database MongoDB yang dikelola sendiri yang menggunakan arsitektur Replica Set, parameter Access Method tidak diatur ke Alibaba Cloud Instance, dan parameter Enkripsi diatur ke SSL-encrypted, Anda bisa mengunggah sertifikat otoritas sertifikasi (CA) untuk memverifikasi koneksi ke database sumber.

      Destination Database

      Select Existing Connection

      • Jika Anda menggunakan instansiasi database yang terdaftar dengan DTS, pilih instansinya dari daftar drop-down. DTS secara otomatis mengisi parameter-parameter database berikut untuk instansi tersebut. Untuk informasi lebih lanjut, lihat Kelola koneksi database.

        Catatan

        Di Konsol DMS, Anda bisa memilih instansiasi database dari daftar drop-down Select a DMS database instance.

      • Jika Anda gagal mendaftarkan instansi dengan DTS, atau Anda tidak perlu menggunakan instansi yang terdaftar dengan DTS, Anda harus mengonfigurasi informasi database berikut.

      Database Type

      Pilih MongoDB.

      Access Method

      Pilih Alibaba Cloud Instance.

      Instance Region

      Pilih wilayah tempat instansiasi ApsaraDB for MongoDB tujuan berada.

      Replicate Data Across Alibaba Cloud Accounts

      Dalam contoh ini, instansiasi database dari akun Alibaba Cloud saat ini digunakan. Pilih No.

      Architecture

      Pilih jenis arsitektur dari instansiasi ApsaraDB for MongoDB tujuan.

      Instance ID

      Pilih ID dari instansiasi ApsaraDB for MongoDB tujuan.

      Authentication Database

      Masukkan nama database tempat akun database dari instansiasi ApsaraDB for MongoDB tujuan milik. Defaultnya adalah admin jika belum diubah.

      Database Name

      Masukkan nama database tempat objek migrasi berada di instansiasi ApsaraDB for MongoDB tujuan.

      Database Account

      Masukkan akun database untuk instansiasi ApsaraDB for MongoDB tujuan. Untuk persyaratan izin, lihat Izin yang diperlukan untuk akun database.

      Database Password

      Kata sandi yang digunakan untuk mengakses instansiasi database.

      Encryption

      Menentukan apakah akan mengenkripsi koneksi ke database tujuan. Anda bisa memilih Non-encrypted, SSL-encrypted, atau Mongo Atlas SSL berdasarkan kebutuhan bisnis Anda. Opsi yang tersedia untuk parameter Encryption ditentukan oleh nilai yang dipilih untuk parameter Access Method dan Architecture. Opsi yang ditampilkan di Konsol DTS berlaku.

      Catatan

      • Jika database tujuan adalah instansiasi ApsaraDB for MongoDB dan parameter Architecture diatur ke Sharded Cluster, parameter Enkripsi SSL-encrypted tidak tersedia.

      • Jika database tujuan adalah database MongoDB yang dikelola sendiri yang menggunakan arsitektur Replica Set, parameter Access Method tidak diatur ke Alibaba Cloud Instance, dan parameter Enkripsi diatur ke SSL-encrypted, Anda bisa mengunggah sertifikat CA untuk memverifikasi koneksi ke database tujuan.

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

      Catatan

      Pastikan blok CIDR server DTS dapat ditambahkan secara otomatis atau manual ke pengaturan keamanan database sumber dan tujuan agar server DTS dapat mengaksesnya. Untuk informasi lebih lanjut, lihat Tambahkan alamat IP server DTS ke daftar putih.

    5. Konfigurasikan objek yang akan dimigrasikan.

      1. Di halaman Configure Objects, konfigurasikan objek yang ingin Anda migrasikan.

        Konfigurasi

        Deskripsi

        Migration Types

        Pilih kedua Schema Migration dan Full Data Migration.

        Processing Mode of Conflicting Tables

        • Precheck and Report Errors: memeriksa apakah database tujuan berisi koleksi yang memiliki nama sama dengan koleksi di database sumber. Jika database sumber dan tujuan tidak berisi koleksi dengan nama identik, pemeriksaan awal berhasil. Jika tidak, kesalahan akan dilaporkan selama pemeriksaan awal dan tugas migrasi data tidak dapat dimulai.

          Catatan

          Jika database sumber dan tujuan berisi koleksi dengan nama identik dan koleksi di database tujuan tidak dapat dihapus atau diubah namanya, Anda bisa menggunakan fitur pemetaan nama objek untuk mengubah nama koleksi yang dimigrasikan ke database tujuan. Untuk informasi lebih lanjut, lihat Peta nama objek.

        • Ignore Errors and Proceed: melewati pemeriksaan awal untuk nama koleksi identik di database sumber dan tujuan.

          Peringatan

          Jika Anda memilih Ignore Errors and Proceed, konsistensi data tidak dijamin dan bisnis Anda mungkin terpapar risiko potensial.

          • DTS tidak memigrasikan catatan data yang memiliki kunci utama yang sama dengan catatan data di database tujuan.

          • Data mungkin gagal diinisialisasi, hanya kolom tertentu yang dimigrasikan, atau tugas migrasi data gagal.

        Capitalization of Object Names in Destination Instance

        Huruf besar/kecil nama database dan nama koleksi di instansi tujuan. Secara default, DTS default policy dipilih. Anda bisa memilih opsi lain untuk memastikan bahwa huruf besar/kecil nama objek sama dengan database sumber atau tujuan. Untuk informasi lebih lanjut, lihat Tentukan huruf besar/kecil nama objek di instansi tujuan.

        Source Objects

        Pilih satu atau lebih objek dari bagian Source Objects. Klik ikon 向右小箭头 untuk menambahkan objek ke bagian Selected Objects.

        Catatan

        Anda bisa memilih objek pada level Database atau Koleksi.

        Selected Objects

        • Untuk menentukan nama objek yang akan dimigrasikan di instansi tujuan atau menentukan objek yang akan menerima data di instansi tujuan, klik kanan objek di bagian Selected Objects. Untuk informasi lebih lanjut, lihat Peta nama objek.

        • Untuk menghapus satu atau lebih objek yang dipilih untuk migrasi, klik objek di bagian Selected Objects lalu klik ikon image untuk memindahkan objek ke bagian Source Objects.

        Catatan

        • Untuk memfilter data berdasarkan kondisi, klik kanan koleksi yang akan dimigrasikan di kotak Selected Objects dan konfigurasikan pengaturan di kotak dialog yang muncul. Untuk informasi lebih lanjut, lihat Atur kondisi filter.

        • Jika Anda menggunakan fitur pemetaan nama objek untuk menentukan database atau koleksi untuk menerima data, objek lain yang bergantung pada objek yang dipetakan mungkin gagal dimigrasikan.

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

        Konfigurasi

        Deskripsi

        Dedicated Cluster for Task Scheduling

        Secara default, DTS menjadwalkan tugas pada klaster bersama, sehingga Anda tidak perlu memilih apa pun. Namun, Anda dapat membeli klaster khusus dengan spesifikasi tertentu untuk menjalankan tugas migrasi DTS. Untuk informasi lebih lanjut, lihat Apa itu klaster khusus DTS?.

        Retry Time for Failed Connections

        Rentang waktu ulang koneksi yang gagal. Jika database sumber atau tujuan gagal terhubung setelah tugas migrasi data dimulai, DTS segera mencoba menghubungkan kembali dalam rentang waktu ulang ini. Nilai valid: 10 hingga 1.440 menit. Nilai default: 720. Disarankan mengatur parameter ini lebih dari 30. Jika DTS berhasil terhubung kembali ke database sumber dan tujuan dalam rentang waktu ulang yang ditentukan, tugas migrasi data dilanjutkan. Jika tidak, tugas migrasi data gagal.

        Catatan

        • Jika Anda menetapkan rentang waktu ulang yang berbeda untuk beberapa tugas migrasi data yang menggunakan database sumber atau tujuan yang sama, nilai yang ditentukan terakhir akan menggantikan nilai sebelumnya.

        • Selama proses pengulangan koneksi, Anda akan dikenai biaya untuk instansiasi DTS. Disarankan menentukan rentang waktu ulang sesuai kebutuhan bisnis Anda. Anda juga dapat melepaskan instansiasi DTS segera setelah database sumber dan tujuan dilepas.

        Retry Time for Other Issues

        Rentang waktu ulang untuk masalah lainnya. Misalnya, jika operasi DDL atau DML gagal setelah tugas migrasi data dimulai, DTS segera mencoba mengulang operasi tersebut dalam rentang waktu ulang ini. Nilai valid: 1 hingga 1.440 menit. Nilai default: 10. Disarankan mengatur parameter ini lebih dari 10. Jika operasi yang gagal berhasil dalam rentang waktu ulang yang ditentukan, DTS melanjutkan tugas migrasi data. Jika tidak, tugas migrasi data gagal.

        Penting

        Nilai parameter Retry Time for Other Issues harus lebih kecil daripada nilai parameter Retry Time for Failed Connections.

        Enable Throttling for Full Data Migration

        Menentukan apakah akan mengaktifkan pembatasan untuk migrasi data penuh. Selama migrasi data penuh, DTS menggunakan sumber daya baca dan tulis dari database sumber dan tujuan, yang dapat meningkatkan beban server database. Anda dapat mengaktifkan pembatasan ini sesuai kebutuhan bisnis. Untuk mengonfigurasi pembatasan, Anda harus menyetel parameter Queries per second (QPS) to the source database, RPS of Full Data Migration, dan Data migration speed for full migration (MB/s). Hal ini membantu mengurangi beban pada server database tujuan.

        Catatan

        Parameter ini hanya dapat dikonfigurasi jika Anda memilih Full Data Migration untuk parameter Migration Types.

        Only one data type for primary key _id in a table of the data to be synchronized

        Menentukan apakah tipe data kunci utama _id bersifat unik dalam koleksi yang akan dimigrasikan.

        Penting

        • Aktifkan parameter ini sesuai kebutuhan bisnis Anda. Jika tidak, risiko kehilangan data dapat terjadi.

        • Parameter ini hanya diperlukan jika Anda memilih Full Data Migration untuk parameter Migration Types.

        Nilai valid:

        • Yes: Tipe data unik. Selama migrasi penuh, DTS tidak memindai tipe data kunci utama di database sumber dan hanya memigrasikan satu tipe data kunci utama dalam koleksi yang akan dimigrasikan.

        • No: Tipe data tidak unik. Selama migrasi penuh, DTS memindai tipe data kunci utama di database sumber dan memigrasikan data dari semua tipe data.

        Environment Tag

        Anda dapat memilih tag lingkungan untuk mengidentifikasi instansiasi sesuai kebutuhan. Pemilihan ini tidak wajib untuk contoh ini.

        Configure ETL

        Menentukan apakah akan mengaktifkan fitur ekstrak, transformasi, dan muat (ETL). Untuk informasi lebih lanjut, lihat Apa itu ETL?. Nilai valid:

        Monitoring and Alerting

        Menentukan apakah akan mengonfigurasi peringatan untuk tugas migrasi data. Jika tugas gagal atau latensi migrasi melebihi ambang batas yang ditentukan, kontak peringatan akan menerima notifikasi. Nilai valid:

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

        Untuk informasi lebih lanjut tentang cara menggunakan fitur verifikasi data, lihat Konfigurasikan tugas verifikasi data.

    6. Simpan pengaturan tugas dan jalankan pemeriksaan awal.

      • Untuk melihat parameter yang harus ditentukan saat memanggil operasi API terkait guna mengonfigurasi tugas DTS, arahkan pointer ke Next: Save Task Settings and Precheck dan klik Preview OpenAPI parameters.

      • Jika Anda tidak perlu melihat atau telah melihat parameter tersebut, klik Next: Save Task Settings and Precheck di bagian bawah halaman.

      Catatan

      • Sebelum memulai tugas migrasi data, DTS melakukan pemeriksaan awal. Anda hanya dapat memulai tugas tersebut setelah lulus pemeriksaan awal.

      • Jika tugas gagal lulus pemeriksaan awal, klik View Details di samping setiap item yang gagal. Setelah menganalisis penyebab berdasarkan hasil pemeriksaan, atasi masalah tersebut, lalu jalankan kembali pemeriksaan awal.

      • Jika muncul peringatan untuk suatu item selama pemeriksaan awal:

        • Jika item peringatan tidak dapat diabaikan, klik View Details di samping item yang gagal, atasi masalah tersebut, lalu jalankan kembali pemeriksaan awal.

        • Jika item peringatan dapat diabaikan, klik Confirm Alert Details. Di kotak dialog Lihat Detail, klik Ignore. Di pesan yang muncul, klik OK, lalu klik Precheck Again untuk menjalankan kembali pemeriksaan awal. Jika Anda mengabaikan item peringatan, inkonsistensi data mungkin terjadi dan bisnis Anda berpotensi menghadapi risiko.

    7. Beli instansiasi.

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

      2. Di halaman Purchase Instance, konfigurasikan parameter Kelas Instansi untuk instansiasi migrasi data. Tabel berikut menjelaskan parameter tersebut.

        Bagian

        Parameter

        Deskripsi

        New Instance Class

        Resource Group

        Grup sumber daya tempat instansiasi migrasi data berada. Nilai default: default resource group. Untuk informasi lebih lanjut, lihat Apa itu Manajemen Sumber Daya?

        Instance Class

        DTS menyediakan kelas instansi yang bervariasi dalam kecepatan migrasi. Anda bisa memilih kelas instansi berdasarkan skenario bisnis Anda. Untuk informasi lebih lanjut, lihat Kelas instansi dari instansiasi migrasi data.

      3. Baca dan setujui Data Transmission Service (Pay-as-you-go) Service Terms dengan mencentang kotak yang tersedia.

      4. Klik Purchase And Start, lalu di kotak dialog OK, klik OK.

        Anda dapat melihat progres instansiasi migrasi di halaman Data Migration Tasks.