Escalonamento e configuração do cluster Azure DocumentDB

Azure DocumentDB proporciona escalabilidade perfeita e alta disponibilidade dentro da região (HA). Este documento serve como um guia rápido para desenvolvedores que desejam aprender a dimensionar e configurar seus clusters.

Pré-requisitos

Uma subscrição do Azure
- Se não tiver uma subscrição Azure, crie uma conta gratuita

Um cluster existente do Azure DocumentDB
- Se não tiver um cluster, crie um novo cluster

Usa o ambiente Bash em Azure Cloud Shell. Para mais informações, consulte Comece com Azure Cloud Shell.
Se preferires executar comandos de referência da CLI localmente, instala CLI do Azure. Se estiveres a correr no Windows ou macOS, considera executar CLI do Azure num contentor Docker. Para mais informações, veja Como executar o CLI do Azure num contentor Docker.
- Se estiveres a usar uma instalação local, inicia sessão na CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga os passos exibidos no seu terminal. Para outras opções de iniciação de sessão, veja Autenticar para Azure usando CLI do Azure.
- Quando for solicitado, instale a extensão CLI do Azure na primeira utilização. Para mais informações sobre extensões, veja Usar e gerir extensões com a CLI do Azure.
- Execute az version para descobrir a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.

Escalar os recursos de computação de cluster

A camada de cluster permite configurar o número de vCores e a quantidade de RAM nos fragmentos físicos do cluster. Você pode alterar a camada de cluster para atender às suas necessidades a qualquer momento sem interrupção. Por exemplo, você pode aumentar de M50 para M60 ou diminuir M50 para M40.

Na barra lateral do cluster, em Configurações, selecione Escala.
Para alterar a camada de cluster, selecione a nova camada no menu suspenso.
Selecione Salvar para manter a alteração.

Para dimensionar a camada de computação do cluster para cima ou para baixo, atualize o cluster existente através de uma operação update alterando o valor MXXX na propriedade compute.tier.

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

Pode usar a API REST do Azure diretamente ou integrada em az rest a partir do ambiente CLI do Azure.

Use este comando para alterar a camada de computação do 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>\"}}}"

Sugestão

Se estiveres a usar o Azure Cloud Shell, podes carregar/descarregar ficheiros diretamente para o shell. Para mais informações, consulte ficheiros geridos no Azure Cloud Shell.

Observação

Não é suportado fazer o downgrade de uma camada de computação regular para uma camada burstable.

Aumente o tamanho do armazenamento

Pode aumentar a capacidade de armazenamento para dar à sua base de dados mais espaço para crescer. Por exemplo, você pode aumentar o armazenamento de 128 GiB para 256 GiB.

Para aumentar o tamanho do armazenamento, selecione o novo tamanho no menu suspenso.
Selecione Salvar para manter a alteração.

Para aumentar o tamanho do armazenamento do cluster, atualize o cluster existente realizando uma operação update ao aumentar o valor na propriedade 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>"

Podes usar a API REST do Azure diretamente ou integrada em az rest a partir do ambiente do CLI do Azure.

Use este comando para alterar a camada de computação do 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>\"}}}"

Sugestão

Se estiveres a usar o Azure Cloud Shell, podes carregar/descarregar ficheiros diretamente para o shell. Para mais informações, consulte ficheiros geridos no Azure Cloud Shell.

Importante

O tamanho do armazenamento só pode ser aumentado, não diminuído.

Ativar ou desativar a alta disponibilidade

Você pode habilitar ou desabilitar a alta disponibilidade (HA) na região para atender às suas necessidades. A HA na região evita o tempo de inatividade do banco de dados mantendo fragmentos de réplica de cada fragmento primário em um cluster. Se um fragmento primário ficar inativo, as conexões de entrada serão redirecionadas automaticamente para o fragmento de réplica, garantindo que haja um tempo de inatividade mínimo.

Para ativar ou desativar a HA na região, alterne a opção de caixa de seleção.
Selecione Salvar para manter a alteração.

Para habilitar a alta disponibilidade na região do cluster, atualize o cluster existente com a operação update, definindo o valor da propriedade highAvailability.targetMode para ZoneRedundantPreferred.

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

Para desabilitar a alta disponibilidade dentro da região no cluster, atualize o cluster existente com uma update operação definindo o valor na highAvailability.targetMode propriedade como Disabled.

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

Podes usar a API REST do Azure diretamente ou incorporada em az rest a partir do ambiente CLI do Azure.

Use este comando para habilitar a alta disponibilidade na região no 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\"}}}"

Use este comando para desabilitar a alta disponibilidade na região no 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\"}}}"

Aumentar o número de fragmentos físicos

Quando um banco de dados cresce além da capacidade de um único cluster de estilhaços físicos, você pode aumentar o tamanho do armazenamento ou adicionar mais fragmentos físicos. Depois que um novo fragmento físico é adicionado ao cluster, você deve executar uma operação de rebalanceamento de cluster para redistribuir dados entre os fragmentos. Cada fragmento físico em um cluster sempre tem a mesma configuração de computação e armazenamento .

Para adicionar fragmentos físicos, selecione o novo número de fragmentos na lista.
Selecione Salvar para manter a alteração.
Selecione Continuar na janela pop-up para manter a alteração.

Para adicionar um fragmento físico ao cluster, atualize o cluster já existente com operações de update aumentando o valor da propriedade sharding.shardCount em um.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.sharding.shardCount="<current-shard-count-plus-one>"
```
Observação

Você pode adicionar apenas um fragmento físico de cada vez. Se você precisar adicionar mais de um fragmento físico ao cluster, precisará fazê-lo sequencialmente.

Podes usar a API REST do Azure diretamente ou incorporada em az rest a partir do ambiente CLI do Azure.

Use este comando para adicionar um fragmento físico ao 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>\"}}}"

Observação

Você pode adicionar apenas um fragmento físico de cada vez. Se você precisar adicionar mais de um fragmento físico ao cluster, precisará fazê-lo sequencialmente.

Sugestão

Se precisares de mais de 10 fragmentos físicos no teu cluster, abre um pedido de suporte.

Reequilibrar dados

Depois que um fragmento físico é adicionado a um cluster, ou se o cluster multishard tem uso de armazenamento desigual em seus fragmentos físicos, o rebalanceamento de dados redistribui os dados entre fragmentos sem qualquer tempo de inatividade.

Na pré-visualização, o rebalanceamento de dados precisa ser ativado no cluster:

No portal Azure, abra as propriedades do cluster.
Em Configurações na página Recursos , selecione Rebalanceador para clusters multiestilhaços.
No painel Rebalanceador para clusters multiestilhaços , selecione Ativar.

Para iniciar o rebalanceamento de dados, conecte-se ao cluster usando uma ferramenta de gerenciamento como o shell Mongo.

Inicie o rebalanceador com o sh.startBalancer() comando.
Verifique o status do rebalanceador usando sh.isBalancerRunning().
Pare o rebalanceador com o sh.stopBalancer() comando.

Observação

A duração do processo de reequilíbrio depende do volume de dados que estão sendo movidos entre fragmentos físicos. A operação é realizada online e não afeta a disponibilidade ou funcionalidade do cluster.

Próximos passos

Neste guia, mostrámos que escalar e configurar o seu cluster Azure DocumentDB no portal Azure é um processo simples. O portal Azure inclui a capacidade de ajustar o nível do cluster, aumentar o tamanho do armazenamento, ativar ou desativar a alta disponibilidade e adicionar shards físicos sem tempo de inatividade.

Restaurar um cluster DocumentDB do Azure

Comentários

Esta página foi útil?

Last updated on 2026-04-17

Partilhar via

Escalonamento e configuração do cluster Azure DocumentDB

Pré-requisitos

Escalar os recursos de computação de cluster

Aumente o tamanho do armazenamento

Ativar ou desativar a alta disponibilidade

Aumentar o número de fragmentos físicos

Reequilibrar dados

Próximos passos

Comentários

Recursos adicionais