All Products
Search
Document Center

ApsaraDB for MongoDB:Migrasi Azure Cosmos DB API for MongoDB ke Alibaba Cloud

Last Updated:Jun 03, 2026

Migrasikan data dari Azure Cosmos DB API for MongoDB ke ApsaraDB for MongoDB menggunakan alat native mongodump dan mongorestore.

Hal-hal yang Perlu Diperhatikan

  • Ini adalah migrasi penuh. Hentikan semua operasi tulis ke database sumber sebelum memulai.

  • Jika sebelumnya Anda menggunakan mongodump untuk mencadangkan database, pindahkan file cadangan tersebut dari folder dump default. Jika tidak, file di folder tersebut akan ditimpa.

  • Jalankan perintah mongodump dan mongorestore pada server tempat MongoDB diinstal, bukan di dalam mongo shell.

Izin yang diperlukan

Instance type

Account permission

Azure Cosmos DB

read

Destination MongoDB instance

readWrite

Prasyarat

  1. Buat instans ApsaraDB for MongoDB. Buat instans.

    Catatan
    • Instans tujuan harus memiliki kapasitas penyimpanan lebih besar daripada data Azure Cosmos DB sumber.

    • Pilih versi MongoDB 4.0 atau yang lebih baru.

  2. Tetapkan password untuk instans ApsaraDB for MongoDB. Tetapkan password.

  3. Instal MongoDB pada sebuah server. Instal MongoDB.

    Catatan
    • Instal MongoDB versi 3.0 atau yang lebih baru.

    • Server ini bersifat sementara. Anda dapat menghentikannya setelah migrasi selesai.

    • Partisi direktori cadangan harus memiliki ruang disk tersedia lebih besar daripada data Azure Cosmos DB sumber.

    Langkah-langkah berikut menggunakan Server Linux sebagai contoh.

Prosedur

  1. Masuk ke portal Azure.

  2. Pada panel navigasi kiri, klik Azure Cosmos DB.

  3. Pada halaman Azure Cosmos DB, klik akun yang akan dimigrasikan.

  4. Pada halaman detail akun, klik Connection String.

  5. Klik tab Read-only Keys.

    Gambar 1. Informasi koneksi Azure. Kolom mencakup HOST (xxx.documents.azure.cn), PORT (10255), USERNAME, PRIMARY PASSWORD, SECONDARY PASSWORD, PRIMARY CONNECTION STRING, SECONDARY CONNECTION STRING, dan SSL (true). Anda hanya memerlukan HOST, USERNAME, dan PRIMARY PASSWORD.

    Catatan

    Izin read-only sudah cukup untuk migrasi ini.

  6. Pada Server Linux, jalankan perintah berikut untuk mencadangkan database sumber.

    mongodump --host <HOST>:10255 --authenticationDatabase admin -u <USERNAME> -p <PRIMARY PASSWORD> --ssl --sslAllowInvalidCertificates
    Catatan

    Ganti <HOST>, <USERNAME>, dan <PRIMARY PASSWORD> dengan nilai dari informasi koneksi Azure.

    Tunggu hingga proses pencadangan selesai. Data disimpan ke folder dump di direktori saat ini.

  7. Dapatkan endpoint node primary dari instans ApsaraDB for MongoDB. Ikhtisar koneksi instans.

  8. Pada Server Linux, jalankan perintah berikut untuk memulihkan data ke instans ApsaraDB for MongoDB.

     mongorestore --host <mongodb_host>:3717 --authenticationDatabase admin -u <username> -p <password> dump
    Catatan
    • <mongodb_host>: endpoint node primary dari instans tujuan.

    • <username>: username database dari instans tujuan.

    • <password>: password database dari instans tujuan.

Tunggu hingga proses restore selesai.