Dimensionamento e configuração do cluster do Azure DocumentDB

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

Prerequisites

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

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

Use o ambiente bash em Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira 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 as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
- Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.
- Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.

Dimensionar os recursos de computação no cluster

A camada do cluster permite configurar o número de vCores e a quantidade de RAM nas shards físicas do cluster. Você pode alterar a camada do cluster para atender às suas necessidades a qualquer momento, sem interrupção. Por exemplo, você pode aumentar de M50 para M60 ou diminuir de 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 aumentar ou reduzir a camada de computação do cluster, atualize o cluster existente com uma operação update, alterando o valor de 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>"

Você pode usar a API REST Azure diretamente ou encapsulada no 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\":{\"compute\":{\"tier\":\"<compute-tier>\"}}}"

Tip

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.

Note

Não há suporte para o downgrade da camada de computação regular para uma camada intermitível .

Aumentar o tamanho de armazenamento

Você pode aumentar a capacidade de tamanho de armazenamento para dar ao 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 operação update aumentando 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>"

Você pode usar a API REST Azure diretamente ou encapsulada no 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>\"}}}"

Tip

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.

Habiliatar ou desabilitar alta disponibilidade

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

Para habilitar ou desabilitar a alta disponibilidade, 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 operação update definindo o valor na propriedade highAvailability.targetMode 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 operação update definindo o valor na propriedade highAvailability.targetMode 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 Azure diretamente ou encapsulada no ambiente do 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 fragmentos 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 a nova contagem de fragmentos na lista.
Selecione Salvar para manter a alteração.
Selecione Continuar na janela pop-up para persistir sua alteração.

Para adicionar uma shard física ao cluster, atualize o cluster existente com uma operação update aumentando o valor da propriedade sharding.shardCount em uma unidade.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.sharding.shardCount="<current-shard-count-plus-one>"
```
Note

Você pode adicionar apenas uma shard física por vez. Se precisar adicionar mais de uma shard física ao cluster, será necessário fazer isso sequencialmente.

Você pode usar a API REST Azure diretamente ou encapsulada no ambiente do CLI do Azure.

Use este comando para adicionar uma shard física 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>\"}}}"

Note

Você pode adicionar apenas uma shard física por vez. Se precisar adicionar mais de uma shard física ao cluster, será necessário fazer isso sequencialmente.

Tip

Se você precisar de mais de 10 fragmentos físicos no cluster, abra um ticket de suporte.

Rebalancear dados

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

Na versão prévia, 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 multi-shard.
No painel Rebalanceador para clusters com várias extensões, selecione Habilitar.

Para iniciar o rebalanceamento de dados, conecte-se ao cluster usando uma ferramenta de gerenciamento, como o shell do 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.

Note

A duração do processo de rebalanceamento depende do volume de dados que está sendo movido entre fragmentos físicos. A operação é executada online e não afeta a disponibilidade ou a funcionalidade do cluster.

Próximas Etapas

Neste guia, mostramos que dimensionar e configurar seu cluster Azure DocumentDB no portal do Azure é um processo simples. O portal 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 nenhum tempo de inatividade.

Restaurar um cluster do Azure DocumentDB

Comentários

Esta página foi útil?

Last updated on 2026-04-27

Dimensionamento e configuração do cluster do Azure DocumentDB

Prerequisites

Dimensionar os recursos de computação no cluster

Aumentar o tamanho de armazenamento

Habiliatar ou desabilitar alta disponibilidade

Aumentar o número de fragmentos físicos

Rebalancear dados

Próximas Etapas

Comentários

Recursos adicionais