Menskalakan dan mengonfigurasi kluster Azure DocumentDB

Azure DocumentDB menyediakan skalabilitas yang mulus dan ketersediaan tinggi dalam wilayah (HA). Dokumen ini berfungsi sebagai panduan cepat bagi pengembang yang ingin mempelajari cara menskalakan dan mengonfigurasi kluster mereka.

Prasyarat

• Langganan Azure

  • Jika Anda tidak memiliki langganan Azure, buat akun gratis

• Kluster Azure DocumentDB yang sudah ada

  • Jika Anda tidak memiliki kluster, buat kluster baru

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai menggunakan Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah az login. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Mengautentikasi ke Azure menggunakan Azure CLI.

  • Saat diminta, instal ekstensi Azure CLI saat pertama kali digunakan. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan dan mengelola ekstensi dengan Azure CLI.

  • Jalankan az version untuk menemukan versi dan pustaka dependen yang terinstal. Untuk meng-upgrade ke versi terbaru, jalankan az upgrade.

Skala komputasi kluster

Tingkat kluster memungkinkan Anda mengonfigurasi jumlah vCore dan jumlah RAM pada pecahan fisik kluster Anda. Anda dapat mengubah tingkat kluster agar sesuai dengan kebutuhan Anda kapan saja tanpa gangguan. Misalnya, Anda dapat meningkatkan dari M50 ke M60 atau mengurangi M50 ke M40.

Portal Azure

1. Pada bilah sisi kluster, di bawah Pengaturan, pilih Skalakan.

2. Untuk mengubah tingkat kluster, pilih tingkat baru dari menu drop-down.

   

3. Pilih Simpan untuk mempertahankan perubahan Anda.

Azure CLI

1. Untuk menskalakan tingkat komputasi kluster ke atas atau ke update bawah, perbarui kluster yang MXXX ada dengan operasi dengan mengubah compute.tier nilai dalam properti .

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.compute.tier="<compute-tier>"
   

REST API

Anda dapat menggunakan Azure REST API secara langsung atau dibungkus dari az rest lingkungan Azure CLI.

1. Gunakan perintah ini untuk mengubah tingkat komputasi kluster:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"compute\":{\"tier\":\"<compute-tier>\"}}}"
   

   Petunjuk / Saran

   Jika Anda menggunakan Azure Cloud Shell, Anda dapat mengunggah/mengunduh file langsung ke shell. Untuk informasi selengkapnya, lihat file terkelola di Azure Cloud Shell.

Nota

Menurunkan tingkat dari tingkat komputasi reguler ke tingkat yang dapat meledak tidak didukung.

Tambah ukuran penyimpanan

Anda dapat meningkatkan ukuran penyimpanan untuk memberi database Anda lebih banyak ruang untuk tumbuh. Misalnya, Anda dapat meningkatkan penyimpanan dari 128 GiB menjadi 256 GiB.

Portal Azure

1. Untuk meningkatkan ukuran penyimpanan, pilih ukuran baru dari menu drop-down.

   

2. Pilih Simpan untuk mempertahankan perubahan Anda.

Azure CLI

1. Untuk meningkatkan ukuran penyimpanan kluster, perbarui kluster yang update ada dengan operasi dengan meningkatkan nilai dalam storage.sizeGb properti . Ukuran penyimpanan yang didukung tercantum di halaman penyimpanan yang didukung.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.storage.sizeGb="<new-size-in-GiB>"
   

REST API

Anda dapat menggunakan Azure REST API secara langsung atau dibungkus dari az rest lingkungan Azure CLI.

1. Gunakan perintah ini untuk mengubah tingkat komputasi kluster:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"storage\":{\"sizeGb\":\"<new-size-in-GiB>\"}}}"
   

   Petunjuk / Saran

   Jika Anda menggunakan Azure Cloud Shell, Anda dapat mengunggah/mengunduh file langsung ke shell. Untuk informasi selengkapnya, lihat file terkelola di Azure Cloud Shell.

Penting

Ukuran penyimpanan hanya dapat ditingkatkan, tidak berkurang.

Mengaktifkan atau menonaktifkan ketersediaan tinggi

Anda dapat mengaktifkan atau menonaktifkan ketersediaan tinggi (HA) dalam wilayah yang sesuai dengan kebutuhan Anda. HA dalam wilayah menghindari downtime database dengan mempertahankan pecahan replika dari setiap shard utama dalam kluster. Jika pecahan primer tidak berfungsi, koneksi masuk secara otomatis dialihkan ke pecahan replikanya, memastikan bahwa waktu henti seminimal mungkin.

Portal Azure

1. Untuk mengaktifkan atau menonaktifkan HA di dalam wilayah, alihkan opsi kotak centang.

   

2. Pilih Simpan untuk mempertahankan perubahan Anda.

Azure CLI

1. Untuk mengaktifkan ketersediaan tinggi di wilayah pada kluster, perbarui kluster yang update ada dengan operasi dengan mengatur nilai dalam highAvailability.targetMode properti ke ZoneRedundantPreferred.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.highAvailability.targetMode="ZoneRedundantPreferred"
   

2. Untuk menonaktifkan ketersediaan tinggi di wilayah pada kluster, perbarui kluster yang update ada dengan operasi dengan mengatur nilai dalam highAvailability.targetMode properti ke Disabled.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.highAvailability.targetMode="Disabled"
   

REST API

Anda dapat menggunakan Azure REST API secara langsung atau dibungkus dari az rest lingkungan Azure CLI.

1. Gunakan perintah ini untuk mengaktifkan ketersediaan tinggi di wilayah pada kluster:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"highAvailability\":{\"targetMode\":\"ZoneRedundantPreferred\"}}}"
   

2. Gunakan perintah ini untuk menonaktifkan ketersediaan tinggi di wilayah pada kluster:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"highAvailability\":{\"targetMode\":\"Disabled\"}}}"
   

Meningkatkan jumlah pecahan fisik

Ketika database tumbuh di luar kapasitas satu kluster shard fisik, Anda dapat meningkatkan ukuran penyimpanan atau menambahkan lebih banyak pecahan fisik. Setelah pecahan fisik baru ditambahkan ke kluster, Anda harus melakukan operasi penyeimbangan ulang kluster untuk mendistribusikan ulang data di seluruh shard. Setiap pecahan fisik dalam kluster selalu memiliki konfigurasi komputasi dan penyimpanan yang sama.

Portal Azure

1. Untuk menambahkan pecahan fisik, pilih jumlah shard baru dari daftar.

   

2. Pilih Simpan untuk mempertahankan perubahan Anda.

3. Pilih Lanjutkan di jendela pop-up untuk mempertahankan perubahan Anda.

Azure CLI

1. Untuk menambahkan shard fisik ke kluster, perbarui kluster yang update ada dengan operasi dengan meningkatkan nilai untuk properti satu per sharding.shardCount satu.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.sharding.shardCount="<current-shard-count-plus-one>"
   

   Nota

   Anda hanya dapat menambahkan satu shard fisik pada satu waktu. Jika Anda perlu menambahkan lebih dari satu shard fisik ke kluster, Anda perlu melakukannya secara berurutan.

REST API

Anda dapat menggunakan Azure REST API secara langsung atau dibungkus dari az rest lingkungan Azure CLI.

1. Gunakan perintah ini untuk menambahkan shard fisik ke kluster:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"sharding\":{\"shardCount\":\"<current-shard-count-plus-one>\"}}}"
   

   Nota

   Anda hanya dapat menambahkan satu shard fisik pada satu waktu. Jika Anda perlu menambahkan lebih dari satu shard fisik ke kluster, Anda perlu melakukannya secara berurutan.

Petunjuk / Saran

Jika Anda memerlukan lebih dari 10 pecahan fisik pada kluster Anda, buka tiket dukungan.

Menyeimbangkan kembali data

Setelah pecahan fisik ditambahkan ke kluster, atau jika kluster multishard memiliki penggunaan penyimpanan yang tidak merata di seluruh pecahan fisiknya, penyeimbangan ulang data mendistribusikan ulang data antar pecahan tanpa waktu henti.

Dalam pratinjau, penyeimbangan ulang data perlu diaktifkan pada kluster:

1. Di portal Microsoft Azure, buka properti kluster.
2. Di bawah Pengaturan di halaman Fitur, pilih Rebalancer untuk kluster multishard.
3. Di panel Rebalancer untuk kluster multishard, pilih opsi Aktifkan.

Untuk memulai penyeimbangan ulang data, sambungkan ke kluster menggunakan alat manajemen seperti shell Mongo.

1. Mulai penyeimbang ulang dengan sh.startBalancer() perintah .

2. Periksa status penyeimbang ulang menggunakan sh.isBalancerRunning().

3. Hentikan penyeimbang ulang dengan sh.stopBalancer() perintah .

Nota

Durasi proses penyeimbangan ulang tergantung pada volume data yang dipindahkan di antara pecahan fisik. Operasi ini dilakukan secara online dan tidak memengaruhi ketersediaan atau fungsionalitas kluster.

Langkah selanjutnya

Dalam panduan ini, kami menunjukkan bahwa penskalaan dan konfigurasi kluster Azure DocumentDB Anda di portal Microsoft Azure adalah proses yang mudah. Portal Microsoft Azure mencakup kemampuan untuk menyesuaikan tingkat kluster, meningkatkan ukuran penyimpanan, mengaktifkan atau menonaktifkan ketersediaan tinggi, dan menambahkan pecahan fisik tanpa waktu henti.

• Opsi komputasi dan penyimpanan
• Lihat dasar-dasar sharding

Memulihkan kluster Azure DocumentDB