Skala och konfigurera Azure DocumentDB-kluster

Azure DocumentDB ger sömlös skalbarhet och hög tillgänglighet (HA) i regionen. Det här dokumentet fungerar som en snabbguide för utvecklare som vill lära sig att skala och konfigurera sina kluster.

Förutsättningar

• En prenumeration på Azure

  • Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto

• Ett befintligt Azure DocumentDB-kluster

  • Om du inte har något kluster skapar du ett nytt kluster

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Kom igång med Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör på Windows eller macOS, överväg att köra Azure CLI i en Docker-container. För mer information, se Hur man kör Azure CLI i en Docker-container.

  • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. För att avsluta autentiseringsprocessen, följ stegen som visas i din terminal. Andra inloggningsalternativ finns i Autentisera till Azure med Azure CLI.

  • När du blir uppmanad, installera Azure CLI-tillägget vid första användning. Mer information om tillägg finns i Använda och hantera tillägg med Azure CLI.

  • Kör az version för att ta reda på versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Skala klusterberäkning

Med klusternivån kan du konfigurera antalet virtuella kärnor och mängden RAM-minne på klustrets fysiska shards. Du kan ändra klusternivån så att den passar dina behov när som helst utan avbrott. Du kan till exempel öka från M50 till M60 eller minska M50 till M40.

Azure Portal

1. I klustrets sidofält går du till Inställningar och väljer Skala.

2. Om du vill ändra klusternivån väljer du den nya nivån i den nedrullningsbara menyn.

   

3. Välj Spara för att spara ändringen.

Azure CLI

1. Om du vill skala upp eller ned klusterberäkningsnivån uppdaterar du det befintliga klustret med en update åtgärd genom att ändra MXXX värdet i egenskapen compute.tier .

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

REST-APIer

Du kan använda Azure REST API direkt eller omslutet från az rest Azure CLI-miljön.

1. Använd det här kommandot för att ändra klusterberäkningsnivå:

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

   Tips/Råd

   Om du använder Azure Cloud Shell kan du ladda upp/ladda ned filer direkt till gränssnittet. Mer information finns i Hanterade filer i Azure Cloud Shell.

Anmärkning

Det går inte att nedgradera från den vanliga beräkningsnivån till en burstbar nivå .

Öka lagringsstorleken

Du kan öka lagringsstorleken för att ge databasen mer utrymme att växa. Du kan till exempel öka lagringen från 128 GiB till 256 GiB.

Azure Portal

1. Om du vill öka lagringsstorleken väljer du den nya storleken på den nedrullningsbara menyn.

   

2. Välj Spara för att spara ändringen.

Azure CLI

1. Om du vill öka klusterlagringsstorleken uppdaterar du det befintliga klustret med en update åtgärd genom att öka värdet i storage.sizeGb egenskapen. Lagringsstorlekar som stöds visas på lagringssidan som stöds.

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

REST-APIer

Du kan använda Azure REST API direkt eller omslutet från az rest Azure CLI-miljön.

1. Använd det här kommandot för att ändra klusterberäkningsnivå:

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

   Tips/Råd

   Om du använder Azure Cloud Shell kan du ladda upp/ladda ned filer direkt till gränssnittet. Mer information finns i Hanterade filer i Azure Cloud Shell.

Viktigt!

Lagringsstorleken kan bara ökas, inte minskas.

Aktivera eller inaktivera hög tillgänglighet

Du kan aktivera eller inaktivera hög tillgänglighet i regionen (HA) för att passa dina behov. Ha i regionen undviker databasavbrott genom att underhålla replikskärvor för varje primär shard i ett kluster. Om en primär shard slutar fungera, omdirigeras inkommande anslutningar automatiskt till dess replikshard, vilket säkerställer minimalt driftstopp.

Azure Portal

1. Om du vill aktivera eller inaktivera HA i regionen kan du markera eller avmarkera kryssrutan.

   

2. Välj Spara för att spara ändringen.

Azure CLI

1. Om du vill aktivera hög tillgänglighet i klustret i regionen uppdaterar du det befintliga klustret med en update åtgärd genom att ange värdet i highAvailability.targetMode egenskapen till ZoneRedundantPreferred.

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

2. Om du vill inaktivera hög tillgänglighet i klustret i regionen uppdaterar du det befintliga klustret med en update åtgärd genom att ange värdet i highAvailability.targetMode egenskapen till Disabled.

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

REST-APIer

Du kan använda Azure REST API direkt eller omslutet från az rest Azure CLI-miljön.

1. Använd det här kommandot för att aktivera hög tillgänglighet i regionen i klustret:

   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. Använd det här kommandot för att inaktivera hög tillgänglighet i klustret i regionen:

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

Öka antalet fysiska fragment

När en databas växer utöver kapaciteten för ett enda fysiskt shardkluster kan du antingen öka lagringsstorleken eller lägga till fler fysiska shards. När en ny fysisk shard har lagts till i klustret måste du utföra en klusterombalanseringsåtgärd för att omdistribuera data över fragmenten. Varje fysisk shard i ett kluster har alltid samma beräknings- och lagringskonfiguration.

Azure Portal

1. Om du vill lägga till fysiska shards väljer du nytt shardantal i listan.

   

2. Välj Spara för att spara ändringen.

3. Välj Fortsätt i popup-fönstret för att spara ändringen.

Azure CLI

1. Om du vill lägga till en fysisk shard i klustret uppdaterar du det befintliga klustret med en update åtgärd genom att öka värdet för sharding.shardCount egenskapen med en.

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

   Anmärkning

   Du kan bara lägga till ett fysiskt fragment i taget. Om du behöver lägga till mer än en fysisk shard i klustret måste du göra det sekventiellt.

REST-APIer

Du kan använda Azure REST API direkt eller omslutet från az rest Azure CLI-miljön.

1. Använd det här kommandot för att lägga till en fysisk shard i klustret:

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

   Anmärkning

   Du kan bara lägga till ett fysiskt fragment i taget. Om du behöver lägga till mer än en fysisk shard i klustret måste du göra det sekventiellt.

Tips/Råd

Om du behöver fler än 10 fysiska shards i ditt kluster, öppna ett supportärende.

Balansera om data

När en fysisk del har lagts till i ett kluster, eller om ett multishard-kluster har ojämn lagringsanvändning över sina fysiska delar, ombalanserar datan mellan delarna utan någon nedtid.

I förhandsversionen måste ombalansering av data aktiveras i klustret:

1. Öppna klusteregenskaper i Azure-portalen.
2. Under Inställningar på sidan Funktioner väljer du Ombalanserare för kluster med flera partitioner.
3. I panelen Ombalansering för kluster med flera partitioner väljer du Aktivera.

Om du vill initiera ombalansering av data ansluter du till klustret med hjälp av ett hanteringsverktyg som Mongo-gränssnittet.

1. Starta ombalanseraren med sh.startBalancer() kommandot .

2. Kontrollera ombalanseringsstatusen med hjälp av sh.isBalancerRunning().

3. Stoppa ombalanseraren med sh.stopBalancer() kommandot .

Anmärkning

Varaktigheten för ombalanseringsprocessen beror på mängden data som flyttas mellan fysiska shards. Åtgärden utförs online och påverkar inte klustertillgänglighet eller -funktioner.

Nästa steg

I den här guiden visade vi att det är enkelt att skala och konfigurera ditt Azure DocumentDB-kluster i Azure-portalen. Azure-portalen innehåller möjligheten att justera klusternivån, öka lagringsstorleken, aktivera eller inaktivera hög tillgänglighet och lägga till fysiska shards utan avbrott.

• Alternativ för compute och lagring
• Kolla in grunderna för horisontell partitionering

Återställa ett Azure DocumentDB-kluster