Escalabilidade e configuração do Azure DocumentDB cluster

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

Pré-requisitos

Uma assinatura do Azure
- Se você não tiver uma assinatura do Azure, crie uma conta gratuita

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

Utilize o ambiente Bash no Azure Cloud Shell. Para mais informações, veja Get started with Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale o CLI do Azure. Se estiver a usar Windows ou macOS, considere executar o Azure CLI num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
- Se você estiver usando uma instalação local, entre 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 entrada, consulte Autenticar no Azure usando a CLI do Azure.
- Quando solicitado, instale a extensão do Azure CLI na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar 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 com uma update operação alterando o MXXX valor na compute.tier propriedade.

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

Você pode usar a API REST do Azure diretamente ou encapsulada no az rest ambiente da 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 você estiver usando o Azure Cloud Shell, poderá carregar/baixar arquivos diretamente no shell. Para obter mais informações, consulte Arquivos gerenciados no Azure Cloud Shell.

Observação

Não há suporte para downgrade de uma camada de computação regular para uma camada burstable .

Aumente o tamanho do armazenamento

Você pode aumentar o tamanho do armazenamento para dar ao seu banco 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 com uma update operação aumentando o valor na storage.sizeGb propriedade. Os tamanhos de armazenamento suportados estão listados na página de armazenamento suportado.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.storage.sizeGb="<new-size-in-GiB>"
```

Você pode usar a API REST do Azure diretamente ou encapsulada no az rest ambiente da 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 você estiver usando o Azure Cloud Shell, poderá carregar/baixar arquivos diretamente no shell. Para obter mais informações, consulte Arquivos gerenciados 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 no cluster, atualize o cluster existente com uma update operação definindo o valor na highAvailability.targetMode propriedade como 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 na 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"

Você pode usar a API REST do Azure diretamente ou encapsulada no az rest ambiente da 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 existente com uma update operação aumentando o valor da sharding.shardCount propriedade 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.

Você pode usar a API REST do Azure diretamente ou encapsulada no az rest ambiente da 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 visualização, o rebalanceamento de dados precisa ser habilitado no cluster:

No portal do 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 do Azure inclui a capacidade de ajustar a camada de cluster, aumentar o tamanho do armazenamento, habilitar ou desabilitar a alta disponibilidade e adicionar fragmentos físicos sem qualquer tempo de inatividade.

Restore an Azure DocumentDB cluster

Feedback

Esta página foi útil?

Last updated on 2025-11-19

Partilhar via

Escalabilidade e configuração do Azure DocumentDB cluster

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

Feedback

Recursos adicionais