Share via

Meningkatkan versi API akun Azure Cosmos DB for MongoDB Anda

  • Artikel

BERLAKU UNTUK: MongoDB

Artikel ini menjelaskan cara memutakhirkan versi API dari API Microsoft Azure Cosmos DB Anda untuk akun MongoDB. Setelah meningkatkan, Anda dapat menggunakan fungsionalitas terbaru di Microsoft Azure Cosmos DB's API untuk MongoDB. Proses pemutakhiran tidak mengganggu ketersediaan akun Anda dan tidak menggunakan RU/dtk atau mengurangi kapasitas database kapan saja. Tidak ada data atau indeks yang ada yang akan dipengaruhi oleh proses ini.

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.

Catatan

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.

Meningkatkan ke 4.2, 4.0 atau 3.6

Manfaat meningkatkan ke versi 4.2: .

  • Beberapa perbaikan besar pada alur agregasi seperti dukungan untuk $merge, Trigonometri, ekspresi aritmetika, dan banyak lagi.
  • Dukungan untuk kelonggaran bidang sisi klien yang selanjutnya mengamankan database Anda dengan memungkinkan masing-masing bidang dienkripsi secara selektif dan menjaga privasi data terenkripsi dari pengguna database dan penyedia hosting.

Manfaat meningkatkan ke versi 4.0

Berikut ini adalah fitur baru yang disertakan dalam versi 4.0:

  • Dukungan untuk transaksi multidokumen dalam koleksi yang tidak dipecah.
  • Operator agregasi baru
  • Performa pemindaian yang disempurnakan
  • Penyimpanan yang lebih cepat dan lebih efisien

Manfaat meningkatkan ke versi 3.6

Berikut ini adalah fitur baru yang disertakan dalam versi 3.6:

  • Peningkatan performa dan stabilitas
  • Dukungan untuk perintah database baru
  • Dukungan untuk alur agregasi secara default dan tahap agregasi baru
  • Dukungan untuk Change Stream
  • Dukungan untuk Indeks majemuk
  • Dukungan lintas partisi untuk operasi berikut: memperbarui, menghapus, menghitung, dan mengurutkan
  • Penyempurnaan performa untuk operasi agregat berikut: $count, $skip, $limit, dan $group
  • Kini mendukung pengindeksan wildcard

Perubahan dari versi 3.2

  • Secara default, fitur Server Side Retry (SSR) diaktifkan, sehingga permintaan dari aplikasi klien tidak akan menghasilkan kesalahan 16500. Sebagai gantinya, permintaan akan dilanjutkan hingga selesai atau mencapai batas waktu 60 detik.
  • Per permintaan, batas waktu diset ke 60 detik.
  • Koleksi MongoDB yang dibuat pada versi protokol kawat baru hanya akan membuat properti _id diindeks secara default.

Tindakan yang diperlukan saat meningkatkan dari 3.2

Saat meningkatkan dari 3.2, sufiks titik akhir akun database akan diperbarui ke format berikut:

<your_database_account_name>.mongo.cosmos.azure.com

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.

Catatan

Titik akhir ini mungkin memiliki sedikit perbedaan jika akun Anda dibuat di Sovereign, Government, atau Restricted Azure Cloud.

Cara meningkatkan

  1. Masuk ke portal Microsoft Azure.

  2. 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.

    Periksa versi akun MongoDB Anda saat ini dari portal Microsoft Azure.

  3. Dari menu kiri, buka Features panel. Tindakan ini akan membuka fitur tingkat Akun yang tersedia untuk akun database Anda.

  4. Pilih baris Upgrade MongoDB server version. Jika opsi ini tidak ada, akun Anda mungkin tidak memenuhi syarat untuk melakukan peningkatan ini. Silakan ajukan tiket dukungan jika itu masalahnya.

    Buka bilah Fitur dan tingkatkan akun Anda.

  5. 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).

    Tinjau panduan pemutakhiran dan pilih pemutakhiran.

  6. Setelah Anda memulai pemutakhiran, menu Fitur berwarna abu-abu dan status diatur ke Tertunda. Peningkatan membutuhkan waktu sekitar 15 menit untuk menyelesaikannya. Proses ini tidak akan memengaruhi fungsionalitas atau operasi akun database yang sudah ada. Setelah selesai, status versi server Update MongoDB akan menampilkan versi yang ditingkatkan. Silakan hubungi dukungan jika ada masalah dalam memproses permintaan Anda.

  7. Berikut ini adalah beberapa pertimbangan setelah memutakhirkan akun Anda:

    1. 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 akan terganggu. Untuk memastikan pengalaman yang konsisten, semua aplikasi Anda harus menggunakan titik akhir yang baru.

    2. Jika Anda meningkatkan dari 3.6, string koneksi yang ada akan ditingkatkan ke versi yang ditentukan dan harus terus digunakan.

Cara menurunkan versi

Anda juga dapat menurunkan versi akun Anda dari 4.0 menjadi 3.6 menggunakan langkah yang sama di bagian sebelumnya, "Cara Meningkatkan".

Jika Anda meningkatkan dari 3.2 ke dan ingin menurunkan versinya kembali ke 3.2, cukup beralih kembali menggunakan string koneksi sebelumnya (3.2) dengan host accountname.documents.azure.com, yang tetap aktif pasca-peningkatan yang menjalankan versi 3.2.

Langkah berikutnya