ApsaraDB for MongoDB：Migrasi API Azure Cosmos DB untuk MongoDB ke ApsaraDB for MongoDB

Peringatan

• Ini adalah migrasi penuh. Untuk memastikan konsistensi data, disarankan menghentikan semua operasi penulisan ke database sebelum migrasi.

• Jika Anda telah menggunakan perintah mongodump untuk mencadangkan database, pindahkan file dalam folder dump ke direktori lain. Pastikan folder dump default kosong sebelum migrasi data. Jika tidak, file cadangan yang ada di folder ini akan ditimpa.

• Jalankan perintah mongodump dan mongorestore pada server tempat MongoDB diinstal. Jangan jalankan perintah ini di shell mongo.

Izin akun database yang diperlukan

Konfigurasi lingkungan

1. Buat instans ApsaraDB for MongoDB. Untuk informasi lebih lanjut, lihat Buat Instans.

   Catatan

   • Kapasitas penyimpanan instans harus lebih besar dari Azure Cosmos DB.

   • Pilih versi MongoDB 4.0 atau yang lebih baru.

2. Tetapkan kata sandi untuk instans ApsaraDB for MongoDB. Untuk informasi lebih lanjut, lihat Tetapkan Kata Sandi.

3. Instal MongoDB pada server. Untuk informasi lebih lanjut, lihat Instal MongoDB.

   Catatan

   • Instal versi MongoDB yang lebih baru dari 3.0.

   • Server ini digunakan untuk menyimpan data sementara selama pencadangan dan pemulihan, dan tidak diperlukan setelah migrasi selesai.

   • Kapasitas disk tempat cadangan disimpan harus lebih besar dari Azure Cosmos DB.

   Contoh ini menginstal MongoDB pada Server Linux. Anda juga dapat menggunakan sistem operasi lain, seperti Windows.

Prosedur

1. Masuk ke portal Azure.

2. Di panel navigasi di sebelah kiri, klik Azure Cosmos DB.

3. Di halaman Azure Cosmos DB, klik nama akun Azure Cosmos DB yang ingin dimigrasikan.

4. Di halaman detail akun, klik Connection String.

5. Klik tab Read-only Keys untuk melihat informasi koneksi database.

   Gambar 1. Informasi Koneksi Azure

   Catatan

   Untuk memigrasikan data, Anda hanya memerlukan akun database dengan izin baca-saja.

6. Jalankan perintah berikut di server MongoDB untuk mencadangkan Azure Cosmos DB ke server ini.

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

   Catatan: Ganti <HOST>, <USERNAME>, dan <SECONDARY PASSWORD> dengan nilai aktual yang ditampilkan di Informasi Koneksi Azure.

   Setelah pencadangan selesai, cadangan Azure Cosmos DB disimpan di folder dump.

7. Dapatkan titik akhir node utama instans ApsaraDB for MongoDB. Untuk informasi lebih lanjut, lihat Ikhtisar Koneksi Instans Set Replika.

8. Jalankan perintah berikut di server MongoDB untuk mengekspor cadangan ke instans ApsaraDB for MongoDB.

    mongorestore --host <mongodb_host>:3717 --authenticationDatabase admin -u <username> -p <password> dump

   Deskripsi parameter:

   • <mongodb_host>: titik akhir node utama instans MongoDB.

   • <username>: akun yang digunakan untuk masuk ke instans ApsaraDB for MongoDB.

   • <password>: kata sandi yang digunakan untuk masuk ke instans ApsaraDB for MongoDB.

Setelah pemulihan selesai, cadangan Azure Cosmos DB berhasil dimigrasikan ke instans ApsaraDB for MongoDB.