Meningkatkan versi API akun Azure Cosmos DB for MongoDB Anda
BERLAKU UNTUK: 
MongoDB
Artikel ini menjelaskan cara memutakhirkan versi API dari API Microsoft Azure Cosmos DB Anda untuk akun MongoDB. Setelah peningkatan, Anda dapat menggunakan fungsionalitas terbaru di API Azure Cosmos DB untuk MongoDB. Proses pemutakhiran tidak mengganggu ketersediaan akun Anda dan tidak menggunakan RU/dtk atau mengurangi kapasitas database kapan saja. Proses ini tidak memengaruhi data atau indeks yang ada.
Saat memutakhirkan ke versi API baru, mulailah dengan beban kerja pengembangan/pengujian sebelum meningkatkan beban kerja produksi. Penting untuk meningkatkan klien Anda ke versi yang kompatibel dengan versi API yang Anda tingkatkan sebelum meningkatkan akun Azure Cosmos DB for MongoDB Anda.
Peringatan
Saat ini, hanya akun yang memenuhi syarat yang menggunakan server versi 3.2 yang dapat ditingkatkan ke versi 3.6 atau 4.0. Jika akun Anda tidak menampilkan opsi peningkatan, silakan ajukan tiket dukungan.
Tingkatkan versi Anda
Masuk ke Portal Microsoft Azure.
Navigasi ke akun Azure Cosmos DB for MongoDB Anda. Buka panel Gambaran Umum dan pastikan bahwa versi Server Anda saat ini adalah 3.2 atau 3.6.
Dari menu kiri, buka
Featurespanel. Tindakan ini akan membuka fitur tingkat Akun yang tersedia untuk akun database Anda.Pilih baris
Upgrade MongoDB server version. Jika opsi ini tidak ada, akun Anda mungkin tidak memenuhi syarat untuk melakukan peningkatan ini. Ajukan tiket dukungan jika demikian.
Tinjau informasi yang ditampilkan tentang peningkatan. Pilih
Set server version to 4.2(atau 4.0 atau 3.6 tergantung pada versi Anda saat ini).
Setelah Anda memulai peningkatan, menu Fitur berwarna abu-abu, dan status diatur ke Tertunda. Peningkatan membutuhkan waktu sekitar 15 menit untuk menyelesaikannya. Proses ini tidak memengaruhi fungsionalitas atau operasi akun database Anda yang ada. Setelah selesai, status versi server Update MongoDB akan menampilkan versi yang ditingkatkan. Hubungi dukungan jika ada masalah saat memproses permintaan Anda.
Berikut ini adalah beberapa pertimbangan setelah memutakhirkan akun Anda:
Jika Anda meningkatkan dari versi 3.2, kembali ke blade Gambaran Umum, dan salin string koneksi baru untuk digunakan dalam aplikasi Anda. String koneksi lama yang menjalankan 3.2 tidak terganggu. Untuk memastikan pengalaman yang konsisten, semua aplikasi Anda harus menggunakan titik akhir yang baru.
Jika Anda meningkatkan dari 3.6, string koneksi yang ada akan ditingkatkan ke versi yang ditentukan dan harus terus digunakan.
Penting
Saat melakukan peningkatan dari 3.2, sufiks titik akhir akun database akan diperbarui ke format berikut: <your_database_account_name>.mongo.cosmos.azure.com. Titik akhir ini mungkin memiliki sedikit perbedaan jika akun Anda dibuat di Sovereign, Government, atau Restricted Azure Cloud.
Jika melakukan peningkatan dari versi 3.2, Anda harus mengganti titik akhir yang ada di aplikasi dan driver yang terhubung dengan akun database ini. Hanya koneksi yang menggunakan titik akhir baru yang akan memiliki akses ke fitur dalam versi API baru. Titik akhir 3.2 sebelumnya harus memiliki akhiran .documents.azure.com.
Saat memutakhirkan dari 3.2 ke versi yang lebih baru, indeks majemuk sekarang diperlukan untuk melakukan operasi penyortiran di berbagai bidang untuk memastikan kinerja yang stabil dan tinggi untuk kueri ini. Memastikan indeks majemuk ini dibuat sehingga jenis multi-bidang Anda berhasil.
Menurunkan versi Anda
Anda juga dapat menurunkan tingkat akun Anda ke 4.0 atau 3.6 melalui langkah yang sama di bagian tingkatkan versi Anda.
Jika Anda meningkatkan dari 3.2 ke dan ingin menurunkan tingkat kembali ke 3.2, beralih kembali menggunakan string koneksi sebelumnya (3.2) dengan host
accountname.documents.azure.com, yang tetap aktif pasca-peningkatan yang berjalan versi 3.2.Ubah string koneksi di aplikasi Anda.