Ekstensi migrasi Azure Cosmos DB for MongoDB untuk Azure Data Studio (pratinjau)

Ekstensi migrasi Azure Cosmos DB for MongoDB membantu Anda memigrasikan beban kerja MongoDB ke Azure Cosmos DB. Anda dapat menggunakan ekstensi ini untuk:

• Jalankan penilaian end-to-end pada beban kerja Anda dan cari tahu tindakan yang diperlukan yang perlu Anda ambil untuk memigrasikan beban kerja Anda ke Azure Cosmos DB berbasis vCore untuk MongoDB.
• Lakukan operasi migrasi dengan database dan koleksi yang dipilih ke Azure Cosmos DB berbasis vCore untuk MongoDB.

Penting

Saat ini ekstensi ini tidak mendukung skenario berikut:

• Migrasi di mana akun sumber atau target diaktifkan Titik Akhir Privat.
• Migrasi Online/Offline untuk Azure Cosmos DB berbasis RU untuk MongoDB.

Untuk informasi selengkapnya tentang solusi alternatif untuk API untuk MongoDB vCore, lihat opsi migrasi.

Prasyarat

• Azure Cosmos DB berbasis vCore yang sudah ada untuk akun MongoDB.
  • Jika Anda tidak memiliki langganan Azure, buat akun secara gratis.
• Versi terbaru Azure Data Studio.
• MongoDB yang menjalankan versi 3.2 atau yang lebih tinggi.
• Tambahkan pengecualian firewall ke sumber MongoDB dan Azure Cosmos DB berbasis vCore untuk akun target MongoDB untuk menerima koneksi dari pusat data Azure global.
• Jika Anda menggunakan Database Migration Service untuk pertama kalinya, pastikan penyedia sumber daya Microsoft.DataMigration terdaftar di langganan Anda.

Siapkan

Sebelum memulai migrasi, lakukan perencanaan dan pengambilan keputusan di muka tentang migrasi Anda sebelum Anda benar-benar memindahkan data apa pun.

• Untuk informasi selengkapnya tentang perencanaan pramigrasi untuk API untuk MongoDB vCore, lihat langkah-langkah pramigrasi untuk Azure Cosmos DB berbasis vCore untuk MongoDB,
• Untuk informasi selengkapnya tentang perencanaan pramigrasi untuk API untuk MongoDB RU, lihat langkah-langkah pramigrasi untuk Azure Cosmos DB berbasis RU untuk MongoDB

Mendaftarkan penyedia sumber daya Microsoft.DataMigration di langganan Anda

Untuk memastikan bahwa penyedia sumber daya Microsoft.DataMigration terdaftar di langganan Anda, Anda dapat mengikuti langkah-langkah berikut:

portal Azure:

1. Buka portal Azure dan navigasikan ke langganan Anda.
2. Di menu sebelah kiri, pilih Penyedia sumber daya di bawah Pengaturan.
3. Cari Microsoft.DataMigration di kotak pencarian di bagian atas.
4. Jika tidak terdaftar, pilih dan klik tombol Daftar.

Azure CLI:

1. Buka Azure Cloud Shell atau terminal lokal Anda.
2. Gunakan perintah berikut untuk mendaftarkan penyedia sumber:

az provider register --namespace Microsoft.DataMigration

PowerShell:

1. Buka Azure Cloud Shell atau PowerShell lokal Anda.
2. Gunakan perintah berikut untuk mendaftarkan penyedia sumber:

Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"

Menginstal ekstensi

Instal ekstensi migrasi Azure Cosmos DB for MongoDB di Azure Data Studio sebelum Anda memulai migrasi.

1. Buka manajer ekstensi di Azure Data Studio. Pilih ikon ekstensi atau pilih Ekstensi di menu Tampilan.

2. Masukkan Cosmos di bilah pencarian.

3. Pilih ekstensi Azure Cosmos DB Migration for MongoDB dan lihat detailnya.

   

4. Pilih Instal.

Mengonfigurasi pengaturan ekstensi

Anda dapat mengonfigurasi beberapa pengaturan ekstensi setelah menginstal ekstensi. Langkah ini bersifat opsional. Jika tidak ada pengaturan yang dikonfigurasi secara eksplisit, ekstensi menggunakan pengaturan default.

1. Buka ekstensi dan pilih Migrasi Azure Cosmos DB untuk MongoDB, pilih ikon kelola pengaturan, lalu pilih pengaturan ekstensi.

   

2. Di bawah pengaturan ekstensi untuk ekstensi ini, berikan Assessment path untuk mengubah lokasi tempat metadata penilaian disimpan. Jika dibiarkan kosong, lokasi default akan digunakan.

Menyambungkan ke sumber MongoDB

Gunakan ekstensi untuk pertama kalinya untuk menyambungkan ke instans sumber MongoDB yang ada. Pastikan Anda memiliki kredensial koneksi untuk sumber yang siap sebelum memulai bagian ini.

1. Temukan ikon koneksi di bilah menu, dan pilih Koneksi Baru.

   

2. Di panel Koneksi , isi bidang berikut ini:

   	Nilai
   Tipe sambungan	Azure Cosmos DB for MongoDB
   String/Parameter koneksi	Gunakan string koneksi atau parameter untuk instans MongoDB sumber yang ada.
   Grup Server	Default
   Nama (opsional)	Berikan nama unik untuk koneksi ini.

3. Pilih Sambungkan.

4. Buka menu konteks untuk koneksi baru di panel Koneksi. Lalu, pilih Kelola.

   

5. Pilih Migrasi Azure Cosmos DB.

   

Jalankan penilaian

Penilaian memeriksa data estate dan pemanfaatan MongoDB Anda saat ini. Fitur penilaian kemudian menghasilkan laporan komprehensif yang membantu Anda mengidentifikasi tindakan yang diperlukan untuk diambil sebelum memigrasikan beban kerja Anda ke Azure Cosmos DB untuk MongoDB.

1. Temukan dan navigasikan ke tab Dasbor . Lalu, pilih Menilai dan Memigrasikan Database.

   

2. Selesaikan wizard untuk memberikan detail ke ekstensi sehingga dapat melakukan penilaian.

   

   1. Di bidang Nama penilaian, masukkan judul.

   2. Pilih target akun Azure Cosmos DB for MongoDB dari menu dropdown Penawaran .

   3. Berikan jalur ke Log MongoDB.

      Tip

      Ini adalah bidang opsional, namun menentukan jalur log menghasilkan temuan yang lebih terperinci di tingkat koleksi. Saat folder log tidak ditentukan, alat ini menggunakan detail dari serverStatus perintah untuk melakukan penilaian.

      Perintah mengembalikan serverStatus penggunaan fitur hanya sejak mulai ulang terakhir, jadi Anda perlu memastikan bahwa waktu yang cukup telah berlalu sejak menghidupkan ulang server terakhir untuk mendapatkan penilaian yang secara akurat mencerminkan beban kerja Anda yang sebenarnya.

   4. Berikan jalur ke Log penilaian data.

      Tip

      Meskipun bidang ini bersifat opsional, menyediakan log penilaian data dapat menghasilkan wawasan yang lebih rinci tentang beban kerja. Log ini diperoleh dengan memindai data dan membaca log verbose. Penilaian data berjalan secara independen sebagai CLI sebelum memulai penilaian migrasi, dan JSON yang dihasilkan kemudian disediakan di sini. Unduh CLI penilaian data di sini.

   5. Pilih Jalankan validasi untuk memvalidasi input penilaian.

3. Setelah validasi berhasil, pilih Mulai penilaian untuk menjalankan penilaian.

   

4. Tergantung pada ukuran server sumber Anda, penilaian membutuhkan waktu beberapa menit. Tunggu hingga penilaian selesai sebelum melanjutkan.

   

5. Setelah penilaian selesai, Anda sekarang harus memiliki laporan penilaian.

   

6. Dalam laporan penilaian, pilih nama instans untuk meninjau daftar masalah di seluruh server. Pilih database tertentu untuk melihat masalah yang hanya berlaku untuk database yang dipilih.

   

7. Pilih Unduh Laporan untuk mendapatkan laporan yang dapat diunduh terkonsolidasi.

8. Pelajari laporan penilaian untuk mengidentifikasi tindakan apa pun yang perlu Anda ambil untuk migrasi mulus beban kerja Anda di Azure Cosmos DB untuk MongoDB. Sebelum pindah ke langkah berikutnya, pastikan bahwa semua masalah pemblokiran yang dilaporkan dalam penilaian ditangani. Jika ada masalah yang belum terselesaikan, Anda dapat keluar dari proses dan menanganinya nanti. Setelah masalah diselesaikan, Anda dapat kembali dan memulai ulang proses penilaian dan migrasi.

Melakukan migrasi

Sekarang, gunakan laporan penilaian untuk melakukan migrasi data Anda dari instans MongoDB sumber Anda ke akun Azure Cosmos DB berbasis vCore target Anda untuk MongoDB.

1. Di layar laporan penilaian, pilih database apa pun yang Anda rencanakan untuk dimigrasikan. Kemudian, pilih Berikutnya.

   

2. Persempit daftar untuk Memilih target akun Azure Cosmos DB for MongoDB dengan memfilter menurut langganan lalu grup sumber daya. Kemudian berikan kredensial koneksi yang diperlukan untuk menyambungkan ke akun.

   

3. Pilih Uji koneksi untuk memvalidasi kredensial untuk akun Azure Cosmos DB for MongoDB. Pilih Berikutnya untuk menavigasi ke pemetaan koleksi dari sumber ke target.

4. Pilih Lewati atau Migrasi untuk setiap koleksi dalam daftar pemetaan. Koleksi yang sudah ada di target secara otomatis ditandai dengan ikon dan diatur ke Lewati secara default. Pilih Berikutnya untuk mengonfigurasi Azure Database Migration Service (DMS).

   

   Peringatan

   Memilih untuk Memigrasikan koleksi yang ada akan menimpa seluruh koleksi, yang mengakibatkan kehilangan data yang tidak dapat dipulihkan. Berhati-hatilah saat memilih opsi ini.

5. Pilih instans Azure Database Migration Service yang sudah ada dari menu dropdown atau pilih Buat Baru untuk membuat layanan migrasi baru. Azure Database Migration Service adalah layanan yang memigrasikan data ke dan dari platform data Azure dengan menggunakan infrastruktur cloud untuk transfer data, alih-alih mengandalkan sumber daya lokal.

   

6. Pilih mode migrasi yang paling sesuai untuk kasus penggunaan Anda.

   • Migrasi online menyalin data pengumpulan, memastikan pembaruan juga direplikasi selama proses. Metode ini menguntungkan dengan waktu henti minimal, memungkinkan operasi berkelanjutan untuk kelangsungan bisnis. Gunakan opsi ini saat operasi yang sedang berlangsung sangat penting, dan mengurangi waktu henti adalah prioritas.
   • Migrasi offline menangkap rekam jepret database di awal, menawarkan pendekatan yang lebih sederhana dan dapat diprediksi. Ini berfungsi dengan baik saat menggunakan salinan statis database dapat diterima, dan pembaruan real time tidak penting.

7. Pilih Berikutnya untuk melihat ringkasan migrasi. Setelah Anda meninjau dan mengonfirmasi detailnya, pilih Buat Skema untuk membuat sumber daya di akun target.

   

8. Pilih Mulai Migrasi untuk memulai transfer data menggunakan layanan migrasi yang dipilih.

   

9. Di pop-up Konfirmasi Pengaturan, verifikasi bahwa pengaturan firewall Anda memenuhi persyaratan. Pilih OK untuk mengonfirmasi.

   

Tugas migrasi data dijalankan di Azure Database Migration Service sehingga Anda tidak diharuskan terhubung ke lingkungan sumber dan target selama migrasi data. Status diperbarui pada dasbor pada interval yang sering

Catatan

Jika Anda memilih lebih dari 50 koleksi untuk dimigrasikan, pekerjaan migrasi akan di-batch ke dalam beberapa pekerjaan pada layanan migrasi, masing-masing berisi maksimal 50 koleksi.

1. Pantau status migrasi di halaman dasbor setelah pekerjaan diinisialisasi.

   

2. Untuk melihat detail selengkapnya, pilih migrasi tertentu dari daftar migrasi.

Memantau migrasi Offline

Status diperbarui secara otomatis setelah semua tugas migrasi data selesai.

Setelah data berhasil disalin dari sumber ke target, status migrasi offline menunjukkan keberhasilan.

• Ubah string koneksi di aplikasi Anda untuk menunjuk ke akun target.

Memantau migrasi Online

Migrasi online, tidak seperti migrasi offline, tidak selesai secara otomatis. Sebaliknya, mereka berjalan terus menerus sampai diselesaikan secara manual dengan memilih Cutover.

Untuk menyelesaikan migrasi online, ikuti langkah-langkah ini dalam urutan tertentu:

1. Tombol Cutover diaktifkan setelah Pemuatan Data Awal selesai untuk semua koleksi. Migrasi saat ini dalam fase replikasi, terus menyalin pembaruan dari instans sumber ke instans target untuk menjaganya tetap terbarui dengan perubahan terbaru.

2. Saat siap untuk melakukan cutover migrasi, hentikan semua transaksi masuk ke koleksi sumber yang sedang dimigrasikan.

3. Pantau perubahan replikasi dalam tabel dan tunggu hingga metrik 'Perubahan Replikasi Diputar' stabil. Metrik 'Perubahan Replikasi yang Diputar' yang stabil menunjukkan bahwa semua pembaruan dari sumber berhasil disalin ke target.

4. Pilih Cutover saat celah replikasi minimal untuk semua koleksi dan metrik 'Perubahan Replikasi Diputar' stabil.

5. Validasi secara manual bahwa jumlah baris sama antara kumpulan sumber dan target.

6. Dalam dialog pop-up. Pilih Selesaikan Cutover.
   

   Catatan

   Melakukan operasi cutover tanpa memvalidasi bahwa sumber dan target disinkronkan dapat mengakibatkan kehilangan data.

7. Tunggu hingga status berubah menjadi Berhasil.

8. Perbarui string koneksi di aplikasi Anda untuk menunjuk ke akun target.

Melihat migrasi dan penilaian sebelumnya

Seringkali berguna untuk meninjau penilaian dan migrasi sebelumnya. Ekstensi ini menyediakan antarmuka untuk meninjau ringkasan penilaian dan migrasi sebelumnya. Ekstensi ini juga menyediakan kemampuan untuk meninjau laporan penilaian historis terperinci.

1. Untuk melihat migrasi sebelumnya, pilih tab Migrasi di toolbar. Daftar migrasi berisi semua migrasi yang dimulai pada komputer saat ini. Anda dapat memilih migrasi tertentu dalam daftar untuk mendapatkan detail selengkapnya.

   

2. Untuk melihat penilaian sebelumnya, pilih tab Penilaian di toolbar. Daftar penilaian berisi semua penilaian yang dimulai pada komputer saat ini.

   

Langkah selanjutnya

Tinjau FAQ untuk ekstensi migrasi Azure Cosmos DB for MongoDB