ApsaraDB for MongoDB:Migrasi MongoDB Atlas menggunakan alat MongoDB

Catatan penggunaan

• Versi mongodump dan mongorestore harus sesuai dengan versi database MongoDB Atlas Anda. Untuk langkah instalasi, lihat dokumentasi resmi Install MongoDB.

• Untuk informasi tentang versi dan mesin penyimpanan yang didukung oleh ApsaraDB for MongoDB, lihat Versi dan mesin penyimpanan. Verifikasi kompatibilitas sebelum melakukan migrasi data antar versi atau mesin penyimpanan yang berbeda.

• Ini adalah migrasi data penuh. Untuk memastikan konsistensi data, hentikan operasi write ke database sumber sebelum memulai migrasi.

• Menjalankan perintah mongodump akan menimpa file backup yang ada di direktori dump. Jika Anda sebelumnya telah menjalankan mongodump pada database sumber, pindahkan file yang ada keluar dari direktori dump dan pastikan bahwa direktori dump tersebut kosong.

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

Izin yang diperlukan

Prasyarat

Pada Konsol ApsaraDB for MongoDB, lakukan langkah-langkah berikut:

1. Buat instans ApsaraDB for MongoDB. Untuk informasi lebih lanjut, lihat Buat instans set replika atau Buat instans kluster sharded.

   Catatan

   • Storage space instans ApsaraDB for MongoDB harus lebih besar daripada instans MongoDB Atlas.

   • Untuk melakukan migrasi data ke instans kluster sharded, lakukan sharding terlebih dahulu. Untuk informasi lebih lanjut, lihat Aktifkan sharding.

2. Tetapkan password database untuk instans ApsaraDB for MongoDB. Untuk informasi lebih lanjut, lihat Reset password.

   Catatan

   Lewati langkah ini jika Anda telah menetapkan password database saat membuat instans.

Pada server on-premises, lakukan langkah-langkah berikut:

1. Instal MongoDB. Untuk informasi lebih lanjut, lihat Install MongoDB.

   Catatan

   • Server ini berfungsi sebagai perantara sementara selama proses backup dan restore, dan tidak lagi diperlukan setelah migrasi selesai.

   • Disk space yang tersedia pada partisi direktori backup harus lebih besar daripada storage space yang digunakan oleh database MongoDB Atlas.

2. Tambahkan Alamat IP publik server on-premises Anda ke daftar putih instans ApsaraDB for MongoDB. Untuk informasi lebih lanjut, lihat Konfigurasi daftar putih.

Migrasi data MongoDB Atlas

1. Login ke Konsol MongoDB Atlas.

2. Tambahkan Alamat IP publik server on-premises Anda ke IP Access List instans MongoDB Atlas. Di panel navigasi kiri, klik Clusters. Pada tab Security, klik Network Access, lalu klik + ADD IP ADDRESS di pojok kanan atas. Di kotak dialog Add IP Access List Entry, masukkan Alamat IP publik server on-premises Anda dan klik Confirm.

3. Pada halaman Clusters, klik nama kluster Anda.

4. Pada tab Command Line Tools, klik COPY di samping perintah mongodump untuk menyalin perintah yang berisi informasi koneksi ke database MongoDB Atlas Anda.

5. Di server on-premises Anda, cadangkan database MongoDB Atlas.

   1. Tempel perintah mongodump yang berisi informasi koneksi ke database MongoDB Atlas Anda.

   2. Ganti <PASSWORD> dengan password database Anda dan <DATABASE> dengan nama database yang akan dicadangkan.

   3. Jalankan perintah tersebut dan tunggu hingga proses pencadangan selesai.

6. Login ke Konsol ApsaraDB for MongoDB dan dapatkan Titik akhir publik instans ApsaraDB for MongoDB Anda.

   • Untuk instans set replika, dapatkan Titik akhir publik dari node primary. Untuk informasi lebih lanjut, lihat Hubungkan ke instans set replika.

   • Untuk instans kluster sharded, dapatkan Titik akhir publik dari salah satu node mongos. Untuk informasi lebih lanjut, lihat Hubungkan ke instans kluster sharded.

   Catatan

   Anda harus mengajukan Titik akhir publik secara manual sebelum langkah ini. Untuk informasi lebih lanjut, lihat Ajukan Titik akhir publik.

7. Di server on-premises Anda, jalankan perintah berikut untuk mengimpor data ke instans ApsaraDB for MongoDB.

   mongorestore --host <mongodb_host>:3717 --authenticationDatabase admin -u <username> -d <database> <database_backupfile_directory>

   Catatan

   • <mongodb_host>: Titik akhir publik dari node primary instans set replika atau node mongos instans kluster sharded.

   • <username>: akun database instans ApsaraDB for MongoDB. Contohnya, test.

   • <database>: database yang akan dipulihkan. Jika backup berisi beberapa database, ulangi langkah ini untuk masing-masing database.

   • <database_backupfile_directory>: direktori tempat file backup database berada.

   Contoh:

   Pulihkan database mongodbtest:

   mongorestore --host dds-bp**********-pub.mongodb.rds.aliyuncs.com:3717 --authenticationDatabase admin -u test -d mongodbtest /dump/mongodbtest

   Pulihkan database test123:

   mongorestore --host dds-bp**********-pub.mongodb.rds.aliyuncs.com:3717 --authenticationDatabase admin -u test -d test123 /dump/test123

8. Saat diminta Enter password:, masukkan password instans ApsaraDB for MongoDB Anda dan tekan Enter.

Setelah pemulihan selesai, database MongoDB Atlas telah berhasil dimigrasikan ke instans ApsaraDB for MongoDB Anda.