Azure DocumentDB-cluster schalen en configureren

Azure DocumentDB biedt naadloze schaalbaarheid en hoge beschikbaarheid in regio's (HA). Dit document fungeert als een snelle handleiding voor ontwikkelaars die willen leren hoe ze hun clusters kunnen schalen en configureren.

Vereiste voorwaarden

Een Azure-abonnement
- Als u geen Azure-abonnement hebt, maakt u een gratis account

Een bestaand Azure DocumentDB-cluster
- Als u geen cluster hebt, maakt u een nieuw cluster

Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met Azure Cloud Shell voor meer informatie.
Als je de voorkeur geeft aan het lokaal uitvoeren van CLI-referentiecommando's, installeer dan de Azure CLI. Als je op Windows of macOS werkt, overweeg dan om Azure CLI in een Docker-container uit te voeren. Voor meer informatie, zie Hoe u de Azure CLI in een Docker-container kunt uitvoeren.
- Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met de opdracht az login. Om het authenticatieproces te voltooien, volgt u de stappen die op uw terminal worden weergegeven. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.
- Wanneer u daarom wordt gevraagd, installeer de Azure CLI-extensie bij het eerste gebruik. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.
- Voer az version uit om de geïnstalleerde versie en de afhankelijke bibliotheken te vinden. Voer az upgrade uit om naar de nieuwste versie te upgraden.

Rekenkracht van clusters schalen

Met de clusterlaag kunt u het aantal vCores en de hoeveelheid RAM op de fysieke shards van uw cluster configureren. U kunt de clusterlaag op elk gewenst moment aanpassen aan uw behoeften zonder onderbreking. U kunt bijvoorbeeld verhogen van M50 naar M60 of M50 verlagen tot M40.

Selecteer Schalen in de zijbalk van het cluster onder Instellingen.
Als u de clusterlaag wilt wijzigen, selecteert u de nieuwe laag in de vervolgkeuzelijst.
Selecteer Opslaan om de wijziging te behouden.

Als u de rekenlaag van het cluster omhoog of omlaag wilt schalen, werkt u het bestaande cluster bij met een update bewerking door de MXXX waarde in de compute.tier eigenschap te wijzigen.

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

U kunt de Azure REST API rechtstreeks of verpakt in az rest de Azure CLI-omgeving gebruiken.

Gebruik deze opdracht om de cluster-rekenlaag te wijzigen:

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

Aanbeveling

Als u de Azure Cloud Shell gebruikt, kunt u bestanden rechtstreeks uploaden/downloaden naar de shell. Zie beheerde bestanden in Azure Cloud Shell voor meer informatie.

Opmerking

Downgraden van de normale rekenlaag naar een burstable-laag wordt niet ondersteund.

Vergroot de opslag

U kunt de opslaggrootte vergroten om uw database meer ruimte te geven om te groeien. U kunt bijvoorbeeld de opslag verhogen van 128 GiB tot 256 GiB.

Als u de opslaggrootte wilt vergroten, selecteert u de nieuwe grootte in de vervolgkeuzelijst.
Selecteer Opslaan om de wijziging te behouden.

Als u de clusteropslaggrootte wilt vergroten, werkt u het bestaande cluster bij met een update bewerking door de waarde in de storage.sizeGb eigenschap te verhogen. Ondersteunde opslaggrootten worden weergegeven op de ondersteunde opslagpagina.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.storage.sizeGb="<new-size-in-GiB>"
```

U kunt de Azure REST API rechtstreeks of verpakt in az rest de Azure CLI-omgeving gebruiken.

Gebruik deze opdracht om de cluster-rekenlaag te wijzigen:

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

Aanbeveling

Als u de Azure Cloud Shell gebruikt, kunt u bestanden rechtstreeks uploaden/downloaden naar de shell. Zie beheerde bestanden in Azure Cloud Shell voor meer informatie.

Belangrijk

De opslaggrootte kan alleen worden verhoogd, niet verminderd.

Hoge beschikbaarheid in- of uitschakelen

U kunt hoge beschikbaarheid binnen een regio in- of uitschakelen om aan uw behoeften te voldoen. In-regio HA voorkomt downtime van databases door replica-shards van elke primaire shard in een cluster te onderhouden. Als een primaire shard uitvalt, worden binnenkomende verbindingen automatisch omgeleid naar de replica-shard, zodat er minimale downtime is.

Als u hoge beschikbaarheid in regio's wilt in- of uitschakelen, wisselt u de selectievakjeoptie om.
Selecteer Opslaan om de wijziging te behouden.

Als u hoge beschikbaarheid in regio's op het cluster wilt inschakelen , werkt u het bestaande cluster bij met een update bewerking door de waarde in de eigenschap in te highAvailability.targetMode stellen op ZoneRedundantPreferred.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.highAvailability.targetMode="ZoneRedundantPreferred"
```
Als u hoge beschikbaarheid in regio's op het cluster wilt uitschakelen , werkt u het bestaande cluster bij met een update bewerking door de waarde in de eigenschap in te highAvailability.targetMode stellen op Disabled.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.highAvailability.targetMode="Disabled"
```

U kunt de Azure REST API rechtstreeks of verpakt in az rest de Azure CLI-omgeving gebruiken.

Gebruik deze opdracht om hoge beschikbaarheid in regio's in te schakelen op het cluster:

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

Gebruik deze opdracht om hoge beschikbaarheid in regio's op het cluster uit te schakelen :

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

Het aantal fysieke shards verhogen

Wanneer een database groter wordt dan de capaciteit van één fysiek shardcluster, kunt u de opslaggrootte vergroten of meer fysieke shards toevoegen. Nadat een nieuwe fysieke shard aan het cluster is toegevoegd, moet u een herverdelingsbewerking voor het cluster uitvoeren om gegevens over de shards opnieuw te distribueren. Elke fysieke shard in een cluster heeft altijd dezelfde reken- en opslagconfiguratie .

Als u fysieke shards wilt toevoegen, selecteert u het nieuwe aantal shards in de lijst.
Selecteer Opslaan om de wijziging te behouden.
Selecteer Doorgaan in het pop-upvenster om de wijziging te behouden.

Als u een fysieke shard aan het cluster wilt toevoegen, werkt u het bestaande cluster bij met een update bewerking door de waarde voor de sharding.shardCount eigenschap met één te verhogen.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.sharding.shardCount="<current-shard-count-plus-one>"
```
Opmerking

U kunt slechts één fysieke shard tegelijk toevoegen. Als u meer dan één fysieke shard aan het cluster moet toevoegen, moet u dit sequentieel doen.

U kunt de Azure REST API rechtstreeks of verpakt in az rest de Azure CLI-omgeving gebruiken.

Gebruik deze opdracht om een fysieke shard toe te voegen aan het cluster:

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

Opmerking

U kunt slechts één fysieke shard tegelijk toevoegen. Als u meer dan één fysieke shard aan het cluster moet toevoegen, moet u dit sequentieel doen.

Aanbeveling

Als u meer dan 10 fysieke shards in uw cluster nodig hebt, opent u een ondersteuningsticket.

Gegevens opnieuw verdelen

Nadat een fysieke shard is toegevoegd aan een cluster of als het multishardcluster ongelijkmatig opslaggebruik heeft voor de fysieke shards, worden gegevens opnieuw verdeeld over shards zonder uitvaltijd.

In de preview-fase moet herverdeling van gegevens zijn ingeschakeld op het cluster:

Open de clustereigenschappen in de Azure-portal.
Selecteer onder Instellingen op de pagina Functies de optie Opnieuw verdelen voor multishardclusters.
Selecteer In het deelvenster Rebalancer voor multishardclusters de optie Inschakelen.

Als u het opnieuw verdelen van gegevens wilt initiëren, maakt u verbinding met het cluster met behulp van een beheerhulpprogramma, zoals de Mongo-shell.

Start de herbalancer met de sh.startBalancer() opdracht.
Controleer de status van de herbalancer met behulp van sh.isBalancerRunning().
Stop de herbalancer met de sh.stopBalancer() opdracht.

Opmerking

De duur van het herverdelingsproces is afhankelijk van het volume van de gegevens die tussen fysieke gegevenssegmenten worden verplaatst. De bewerking wordt online uitgevoerd en heeft geen invloed op de beschikbaarheid of functionaliteit van clusters.

Volgende stappen

In deze handleiding hebben we laten zien dat het schalen en configureren van uw Azure DocumentDB-cluster in Azure Portal een eenvoudig proces is. Azure Portal bevat de mogelijkheid om de clusterlaag aan te passen, de opslaggrootte te vergroten, hoge beschikbaarheid in of uit te schakelen en fysieke shards toe te voegen zonder uitvaltijd.

Een Azure DocumentDB-cluster herstellen

Feedback

Is deze pagina nuttig?

Last updated on 2025-11-19

Delen via

Azure DocumentDB-cluster schalen en configureren

Vereiste voorwaarden

Rekenkracht van clusters schalen

Vergroot de opslag

Hoge beschikbaarheid in- of uitschakelen

Het aantal fysieke shards verhogen

Gegevens opnieuw verdelen

Volgende stappen

Feedback

Aanvullende resources