Azure Cosmos DB voor MongoDB vCore biedt naadloze schaalbaarheid en hoge beschikbaarheid binnen een regio (HA). Dit document fungeert als een snelle handleiding voor ontwikkelaars die willen leren hoe ze hun clusters kunnen schalen en configureren.
Vereisten
- Een bestaand Azure Cosmos DB voor MongoDB-cluster (vCore).
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>\"}}}"
Notitie
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>\"}}}"
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
Belangrijk
Fysieke shard toevoegen en herverdeling van gegevens in Azure Cosmos DB voor MongoDB vCore bevindt zich momenteel in de preview-fase. Deze preview-versie wordt geleverd zonder service level agreement en wordt niet aanbevolen voor productieworkloads. Sommige functies worden niet ondersteund of hebben beperkte mogelijkheden.
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>"
Notitie
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>\"}}}"
Notitie
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.
Als u meer dan 10 fysieke shards in uw cluster nodig hebt, neemt u contact op met ons team voor hulp.
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.
Notitie
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 het cluster.
Volgende stappen
In deze handleiding hebben we laten zien dat het schalen en configureren van uw Cosmos DB voor MongoDB vCore-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.