Ridimensionamento e configurazione di Azure cluster DocumentDB

Azure DocumentDB offre scalabilità senza interruzioni e alta disponibilità (HA) nella regione. Questo documento è una guida rapida per gli sviluppatori che vogliono apprendere come ridimensionare e configurare i cluster.

Prerequisiti

• Sottoscrizione di Azure

  • Se non si ha una sottoscrizione Azure, creare un account free

• Un cluster esistente di DocumentDB di Azure

  • Se non si ha un cluster, creare un nuovo cluster

• Usa l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Introduzione a Azure Cloud Shell.

  

• Se si preferisce eseguire i comandi CLI di riferimento in locale, installa interfaccia della riga di comando di Azure. Se si esegue in Windows o macOS, è consigliabile eseguire interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire il interfaccia della riga di comando di Azure in un contenitore Docker.

  • Se si usa un'installazione locale, accedere al interfaccia della riga di comando di Azure usando il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Authenticate to Azure using interfaccia della riga di comando di Azure.For other sign-in options, see Authenticate to Azure using interfaccia della riga di comando di Azure.

  • Quando richiesto, installare l'estensione interfaccia della riga di comando di Azure al primo uso. Per altre informazioni sulle estensioni, vedere Usare e gestire le estensioni con interfaccia della riga di comando di Azure.

  • Esegui az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, avviare az upgrade.

Espandere la capacità di calcolo del cluster.

Il livello cluster consente di configurare il numero di vCore e la quantità di RAM nelle partizioni fisiche del cluster. È possibile modificare il livello del cluster in base alle esigenze in qualsiasi momento senza interruzioni. Ad esempio, è possibile aumentare da M50 a M60 o ridurre M50 a M40.

Azure

1. Nella barra laterale del cluster, in Impostazioniselezionare Ridimensiona.

2. Per modificare il livello del cluster, selezionare il nuovo livello dal menu a discesa.

   

3. Selezionare Salva per rendere persistente la modifica.

interfaccia della riga di comando di Azure

1. Per aumentare o diminuire il livello di calcolo del cluster, aggiornare il cluster esistente con un'operazione update modificando il valore MXXX nella proprietà compute.tier.

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

API REST

È possibile usare l'API REST di Azure direttamente oppure integrata in az rest dall'ambiente interfaccia della riga di comando di Azure.

1. Usare questo comando per modificare il livello di calcolo del 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\":{\"compute\":{\"tier\":\"<compute-tier>\"}}}"
   

   Suggerimento

   Se si usa il Azure Cloud Shell, è possibile caricare/scaricare file direttamente nella shell. Per altre informazioni, vedere file gestiti in Azure Cloud Shell.

Annotazioni

Il downgrade dal livello di calcolo normale a un livello con capacità di burst non è supportato.

Aumentare le dimensioni di archiviazione

È possibile aumentare la capacità di archiviazione per offrire al database più spazio di crescita. Ad esempio, è possibile aumentare lo spazio di archiviazione da 128 GiB a 256 GiB.

Azure

1. Per aumentare le dimensioni di archiviazione, selezionare le nuove dimensioni dal menu a discesa.

   

2. Selezionare Salva per rendere persistente la modifica.

interfaccia della riga di comando di Azure

1. Per aumentare le dimensioni di archiviazione del cluster, aggiornare il cluster esistente con un'operazione update aumentando il valore della proprietà storage.sizeGb.

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

API REST

È possibile usare direttamente l'API REST di Azure o integrata in az rest nell'ambiente interfaccia della riga di comando di Azure.

1. Usare questo comando per modificare il livello di calcolo del 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\":{\"storage\":{\"sizeGb\":\"<new-size-in-GiB>\"}}}"
   

   Suggerimento

   Se si usa il Azure Cloud Shell, è possibile caricare/scaricare file direttamente nella shell. Per altre informazioni, vedere file gestiti in Azure Cloud Shell.

Importante

Le dimensioni di archiviazione possono essere soltanto aumentate, non diminuite.

Abilitare o disabilitare la disponibilità elevata

È possibile abilitare o disabilitare la disponibilità elevata nell'area in base alle proprie esigenze. La disponibilità elevata nell'area evita i tempi di inattività del database mantenendo le partizioni di replica di ogni partizione primaria in un cluster. Se una partizione primaria diventa inattiva, le connessioni in ingresso vengono reindirizzate automaticamente alla partizione di replica, garantendo un tempo di inattività minimo.

Azure

1. Per abilitare o disabilitare l'HA regionale, selezionare o deselezionare l'opzione della casella di controllo.

   

2. Selezionare Salva per rendere persistente la modifica.

interfaccia della riga di comando di Azure

1. Per abilitare la disponibilità elevata a livello di area nel cluster, aggiornare il cluster esistente con un'operazione update impostando il valore della proprietà highAvailability.targetMode su ZoneRedundantPreferred.

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

2. Per disabilitare la disponibilità elevata a livello di area nel cluster, aggiornare il cluster esistente con un'operazione update impostando il valore della proprietà highAvailability.targetMode su Disabled.

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

API REST

È possibile usare direttamente l'Azure REST API o integrarla in az rest dall'ambiente interfaccia della riga di comando di Azure.

1. Usare questo comando per abilitare la disponibilità elevata a livello di area nel 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\"}}}"
   

2. Usare questo comando per disabilitare la disponibilità elevata a livello di area nel 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\":\"Disabled\"}}}"
   

Aumentare il numero di partizioni fisiche

Quando un database aumenta oltre la capacità di un singolo cluster di partizioni fisiche, è possibile aumentare le dimensioni di archiviazione o aggiungere più partizioni fisiche. Dopo l'aggiunta di una nuova partizione fisica al cluster, è necessario eseguire un'operazione di ribilanciamento del cluster per ridistribuire i dati tra le partizioni. Ogni partizione fisica in un cluster ha sempre la stessa configurazione di calcolo e archiviazione.

Azure

1. Per aggiungere partizioni fisiche, selezionare il nuovo numero di partizioni dall'elenco.

   

2. Selezionare Salva per rendere persistente la modifica.

3. Selezionare Continua nella finestra popup per rendere persistente la modifica.

interfaccia della riga di comando di Azure

1. Per aggiungere una partizione fisica al cluster, aggiornare il cluster esistente con un'operazione update aumentando di un’unità il valore della proprietà 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>"
   

   Annotazioni

   È possibile aggiungere una sola partizione fisica alla volta. Se è necessario aggiungere più di una partizione fisica al cluster, le operazioni devono essere eseguite in sequenza.

API REST

È possibile usare direttamente l'API REST di Azure o incapsularla in az rest dall'ambiente interfaccia della riga di comando di Azure.

1. Usare questo comando per aggiungere una partizione fisica al 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>\"}}}"
   

   Annotazioni

   È possibile aggiungere una sola partizione fisica alla volta. Se è necessario aggiungere più di una partizione fisica al cluster, le operazioni devono essere eseguite in sequenza.

Suggerimento

Se sono necessarie più di 10 partizioni fisiche nel cluster, aprire un ticket di supporto.

Ribilancia dati

Dopo l'aggiunta di una partizione fisica a un cluster o se un cluster a più partizioni ha un utilizzo di archiviazione non uniforme tra le partizioni fisiche, il ribilanciamento dei dati ridistribuisce i dati tra le partizioni senza tempi di inattività.

In anteprima, il ribilanciamento dei dati deve essere abilitato nel cluster:

1. Nel portale di Azure aprire le proprietà del cluster.
2. In Impostazioni nella pagina Funzionalità selezionare Ribilanciamento per i cluster con più partizioni.
3. Nel pannello Ribilanciamento per cluster a più partizioni selezionare Abilita.

Per avviare il ribilanciamento dei dati, connettersi al cluster usando uno strumento di gestione, ad esempio la shell Mongo.

1. Avviare il ribilanciamento con il sh.startBalancer() comando .

2. Controllare lo stato del ribilanciamento usando sh.isBalancerRunning().

3. Arrestare il ribilanciamento con il sh.stopBalancer() comando .

Annotazioni

La durata del processo di ribilanciamento dipende dal volume di dati spostati tra partizioni fisiche. L'operazione viene eseguita online e non influisce sulla disponibilità o sulle funzionalità del cluster.

Passaggi successivi

In questa guida è stato illustrato che il ridimensionamento e la configurazione del cluster documentDB Azure nel portale di Azure è un processo semplice. Il portale Azure include la possibilità di modificare il livello del cluster, aumentare le dimensioni di archiviazione, abilitare o disabilitare la disponibilità elevata e aggiungere partizioni fisiche senza tempi di inattività.

• Opzioni di calcolo e archiviazione
• Vedere nozioni fondamentali sul partizionamento orizzontale

Restore an Azure DocumentDB cluster