Azure DocumentDB kümesini ölçeklendirme ve yapılandırma

Azure DocumentDB sorunsuz ölçeklenebilirlik ve bölge içi yüksek kullanılabilirlik (HA) sağlar. Bu belge, kümelerini ölçeklendirmeyi ve yapılandırmayı öğrenmek isteyen geliştiriciler için hızlı bir kılavuz görevi görür.

Önkoşullar

• Azure aboneliği

  • Azure aboneliğiniz yoksa ücretsiz bir hesap oluşturun

• Mevcut bir Azure DocumentDB kümesi

  • Kümeniz yoksa yeni bir küme oluşturun

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz. Azure Cloud Shell'i kullanmaya başlama.

  

• CLI referans komutlarını yerel olarak çalıştırmayı tercih ediyorsanız, Azure CLI'yi yükleyin. Windows veya macOS üzerinde çalışıyorsanız, Azure CLI'yi bir Docker konteynerinde çalıştırmayı düşünün. Daha fazla bilgi için Azure CLI'nin bir Docker konteynerında nasıl çalıştırılacağını inceleyin.

  • Yerel bir kurulum kullanıyorsanız, az login komutunu kullanarak Azure CLI'ye giriş yapın. Kimlik doğrulama işlemini tamamlamak için, terminalinizde görüntülenen adımları takip edin. Diğer oturum açma seçenekleri için bkz. Azure CLI kullanarak Azure'da kimlik doğrulaması.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma ve yönetme.

  • Yüklü olan sürümü ve bağımlı kütüphaneleri bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Küme hesaplamasını ölçeklendirme

Küme katmanı, kümenizinfiziksel parçalarında sanal çekirdek sayısını ve RAM miktarını yapılandırmanıza olanak tanır. Küme katmanını istediğiniz zaman kesintisiz olarak gereksinimlerinize uyacak şekilde değiştirebilirsiniz. Örneğin, M50'den M60'a yükseltebilir veya M50'yi M40'a düşürebilirsiniz.

Azure portalı

1. Küme kenar çubuğundaki Ayarlar'ın altında Ölçek'i seçin.

2. Küme katmanını değiştirmek için açılan menüden yeni katmanı seçin.

   

3. Değişikliğinizi kalıcı hale getirmek için Kaydet'i seçin.

Azure CLI

1. Küme işlem katmanını büyütmek veya küçültmek için özelliğindeki değeri değiştirerek mevcut kümeyi update bir MXXX işlemle güncelleştirincompute.tier.

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

REST API'leri

Azure REST API'sini doğrudan kullanabilir veya Azure CLI ortamından alınan az rest ile sarabilirsiniz.

1. Küme işlem katmanını değiştirmek için şu komutu kullanın:

   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>\"}}}"
   

   Tavsiye

   Azure Cloud Shell kullanıyorsanız dosyaları doğrudan kabuğa yükleyebilir/indirebilirsiniz. Daha fazla bilgi için bkz. Azure Cloud Shell'de yönetilen dosyalar.

Uyarı

Normal işlem katmanından hızla artırılabilir katmana düşürme desteklenmez.

Depolama boyutunu artırın

Veritabanınıza büyümek için daha fazla alan açmak için depolama boyutunu artırabilirsiniz. Örneğin, depolama alanını 128 GiB'den 256GiB'ye çıkarabilirsiniz.

Azure portalı

1. Depolama boyutunu artırmak için açılan menüden yeni boyutu seçin.

   

2. Değişikliğinizi kalıcı hale getirmek için Kaydet'i seçin.

Azure CLI

1. Küme depolama boyutunu artırmak için özelliğindeki değeri artırarak mevcut kümeyi bir update işlemle güncelleştirin storage.sizeGb . Desteklenen depolama boyutları desteklenen depolama sayfasında listelenir.

   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'leri

Azure REST API'sini doğrudan kullanabilir veya Azure CLI ortamından alınan az rest ile sarabilirsiniz.

1. Küme işlem katmanını değiştirmek için şu komutu kullanın:

   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>\"}}}"
   

   Tavsiye

   Azure Cloud Shell kullanıyorsanız dosyaları doğrudan kabuğa yükleyebilir/indirebilirsiniz. Daha fazla bilgi için bkz. Azure Cloud Shell'de yönetilen dosyalar.

Önemli

Depolama boyutu yalnızca artırılabilir, azaltılamaz.

Yüksek kullanılabilirliği etkinleştirme veya devre dışı bırakma

Bölge içi yüksek kullanılabilirliği (HA) gereksinimlerinize uyacak şekilde etkinleştirebilir veya devre dışı bırakabilirsiniz. Bölge içi HA, kümedeki her birincil parçanın çoğaltma parçalarını koruyarak veritabanı kesinti süresini önler. Ana parça devre dışı kalırsa, gelen bağlantılar otomatik olarak yedek parçaya yönlendirilir ve minimum kesinti süresi sağlanır.

Azure portalı

1. Bölge içi HA'yı etkinleştirmek veya devre dışı bırakmak için onay kutusu seçeneğini değiştirin.

   

2. Değişikliğinizi kalıcı hale getirmek için Kaydet'i seçin.

Azure CLI

1. Kümede bölge içi yüksek kullanılabilirliği etkinleştirmek için özelliğindeki updatedeğeri olarak ayarlayarak mevcut kümeyi bir highAvailability.targetMode işlemle güncelleştirinZoneRedundantPreferred.

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

2. Kümede bölge içi yüksek kullanılabilirliği devre dışı bırakmak için özelliğindeki updatedeğeri olarak ayarlayarak mevcut kümeyi bir highAvailability.targetMode işlemle güncelleştirinDisabled.

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

REST API'leri

Azure REST API'sini doğrudan kullanabilir veya Azure CLI ortamından alınan az rest ile sarabilirsiniz.

1. Kümede bölge içi yüksek kullanılabilirliği etkinleştirmek için şu komutu kullanın:

   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. Kümede bölge içi yüksek kullanılabilirliği devre dışı bırakmak için şu komutu kullanın:

   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\"}}}"
   

Fiziksel parça sayısını artırma

Veritabanı tek bir fiziksel parça kümesinin kapasitesini aştığında , depolama boyutunu artırabilir veya daha fazla fiziksel parça ekleyebilirsiniz. Kümeye yeni bir fiziksel parça eklendikten sonra, verileri parçalar arasında yeniden dağıtmak için bir küme yeniden dengeleme işlemi gerçekleştirmeniz gerekir. Bir kümedeki her fiziksel parça her zaman aynı işlem ve depolama yapılandırmasına sahiptir.

Azure portalı

1. Fiziksel parçalar eklemek için listeden yeni parça sayısını seçin.

   

2. Değişikliğinizi kalıcı hale getirmek için Kaydet'i seçin.

3. Değişikliğinizi kalıcı hale getirmek için açılır pencerede Devam'ı seçin.

Azure CLI

1. Kümeye fiziksel bir parça eklemek için özelliğin değerini bir artırarak mevcut kümeyi bir update işlemle güncelleştirin sharding.shardCount .

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

   Uyarı

   Aynı anda yalnızca bir fiziksel parça ekleyebilirsiniz. Kümeye birden fazla fiziksel parça eklemeniz gerekiyorsa, bunu sırayla yapmanız gerekir.

REST API'leri

Azure REST API'sini doğrudan kullanabilir veya Azure CLI ortamından alınan az rest ile sarabilirsiniz.

1. Kümeye fiziksel bir parça eklemek için şu komutu kullanın:

   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>\"}}}"
   

   Uyarı

   Aynı anda yalnızca bir fiziksel parça ekleyebilirsiniz. Kümeye birden fazla fiziksel parça eklemeniz gerekiyorsa, bunu sırayla yapmanız gerekir.

Tavsiye

Kümenizde 10'dan fazla fiziksel parçaya ihtiyacınız varsa bir destek bileti açın.

Verileri yeniden dengeleme

Bir kümeye fiziksel parça eklendikten sonra veya çok parçalı küme fiziksel parçalar arasında eşit olmayan depolama kullanımına sahipse, verileri yeniden dengeleme, kesinti olmadan verileri parçalar arasında yeniden dağıtır.

Önizlemede, kümede veri yeniden dengelemenin etkinleştirilmesi gerekir:

1. Azure portalında küme özelliklerini açın.
2. Özellikler sayfasındaki Ayarlar'ın altında Çok parçalı kümeler için yeniden dengeleyici'yi seçin.
3. Çok parçalı kümeler için yeniden dengeleyici panelinde Etkinleştir'i seçin.

Verileri yeniden dengelemeyi başlatmak için Mongo kabuğu gibi bir yönetim aracı kullanarak kümeye bağlanın.

1. sh.startBalancer() komutunu kullanarak yeniden dengeleyiciyi başlatın.

2. Yeniden dengeleyici durumunu sh.isBalancerRunning() kullanarak denetleyin.

3. komutuyla yeniden dengeleyiciyi sh.stopBalancer() durdurun.

Uyarı

Yeniden dengeleme işleminin süresi, fiziksel parçalar arasında taşınan veri hacmine bağlıdır. İşlem çevrimiçi gerçekleştirilir ve küme kullanılabilirliğini veya işlevselliğini etkilemez.

Sonraki Adımlar

Bu kılavuzda, Azure portalda Azure DocumentDB kümenizi ölçeklendirmenin ve yapılandırmanın basit bir işlem olduğunu gösterdik. Azure portalı küme katmanını ayarlama, depolama boyutunu artırma, yüksek kullanılabilirliği etkinleştirme veya devre dışı bırakma ve kapalı kalma süresi olmadan fiziksel parçalar ekleme olanağını içerir.

• İşlem ve depolama seçenekleri
• Parçalama ile ilgili temel bilgilere göz atın

Azure DocumentDB kümesini geri yükleme