Todos os produtos
Search
Central de documentação

ApsaraDB for MongoDB:Alterar configurações de shard

Última atualização: Aug 21, 2026

Se um shard não atender mais às suas necessidades de armazenamento ou apresentar gargalos de desempenho, altere as especificações da instância ou a capacidade de armazenamento. Instâncias de cluster com sharding do ApsaraDB for MongoDB permitem modificar configurações, como especificações e capacidade de armazenamento, em um ou mais shards.

Limitações

  • A capacidade de armazenamento selecionada deve ser maior ou igual ao espaço atualmente utilizado pelo shard.

  • O número de nós somente leitura selecionado deve ser maior ou igual ao maior número de nós somente leitura existente em qualquer shard da instância.

  • Não é possível aumentar o número de nós somente leitura durante o downgrade de uma instância por assinatura.

Regras de faturamento

Para mais informações, consulte Configuration change fees.

Precauções

  • Ao alterar as especificações da instância, podem ocorrer uma ou duas desconexões transitórias, cada uma com duração aproximada de 30 segundos. Agende o horário do switchover para minimizar o impacto nas cargas de trabalho.

    Importante

    Ao alterar apenas a capacidade de armazenamento, o impacto do scale-up varia entre instâncias que utilizam discos cloud e instâncias que utilizam discos locais.

    • Em instâncias com discos cloud, o aumento da capacidade de armazenamento não afeta os serviços. Nenhuma desconexão transitória ocorre e a alteração entra em vigor imediatamente.

    • Em instâncias com discos locais, o sistema executa operações diferentes dependendo da disponibilidade de recursos de armazenamento no host. Se houver recursos suficientes, o armazenamento é expandido localmente, sem migração entre máquinas físicas ou switchover. Nesse caso, não há desconexão transitória e a mudança é aplicada imediatamente. Caso contrário, são necessárias migração entre máquinas físicas e switchover. Uma desconexão transitória ocorrerá e a alteração entrará em vigor no horário de switchover especificado.

  • A duração de uma alteração de configuração depende de diversos fatores, como condições de rede, fila de tarefas e volume de dados. Recomendamos executar essa operação fora dos horários de pico e garantir que a aplicação possua um mecanismo de reconexão automática.

  • Se o banco de dados estiver executando uma versão secundária desatualizada e sem suporte, o sistema a atualiza automaticamente para a versão mais recente durante a alteração de configuração, garantindo melhor desempenho e estabilidade.

  • Modificações em instâncias com disco local demoram significativamente mais do que em instâncias com disco cloud, que geralmente são concluídas em até uma hora.

    Fatores que afetam a duração de uma alteração de configuração

    Se o servidor físico host não tiver recursos suficientes, a modificação de uma instância com disco local aciona uma migração entre hosts, aumentando consideravelmente a duração. Quando o host possui recursos adequados, a alteração é aplicada localmente. A tabela a seguir lista os principais fatores.

    Tipo de armazenamento

    Migração entre hosts

    Fator influente

    Descrição

    Disco local

    Não

    Quantidade de bancos de dados e coleções

    Alterações de configuração reiniciam os nós. Um maior número de bancos de dados e coleções aumenta o tempo de inicialização. Remova regularmente aqueles que não são utilizados. Instance slowdowns or exceptions due to an excessive number of databases and collections.

    Criação de índice em andamento

    Alterações de configuração reiniciam os nós. A criação de índices em progresso força uma reconstrução, aumentando o tempo de inicialização.

    Sim

    Tamanho total dos dados

    O tamanho total dos dados afeta o tempo de migração e sincronização. A velocidade de migração é limitada pela largura de banda da rede do tipo de instância.

    Taxa de gravação de dados incrementais

    Taxas de gravação mais altas aumentam o tempo necessário para o novo nó sincronizar dados incrementais.

    Período de retenção do Oplog

    Se o período de retenção do Oplog for muito curto, logs incrementais podem ser sobrescritos, causando falha na sincronização. Garanta que o período de retenção atenda à fórmula: Período de Retenção (horas) ≥ Espaço de Dados Utilizado (GB) / 10 (GB/hora).

    Status do backup diário

    Os dados podem ser migrados usando conjuntos de backup se os backups diários apresentarem fragmentação mínima de disco e um período de retenção do Oplog suficiente.

    Número de índices

    Um maior número de índices aumenta o tempo de criação de índices no novo nó durante a sincronização.

    Quantidade de bancos de dados e coleções

    Mais bancos de dados e coleções aumentam o tempo de sincronização no novo nó.

    Disco cloud

    Não

    -

    Alterações de configuração em disco cloud utilizam snapshots e são concluídas rapidamente. Os fatores acima não se aplicam.

    Nota

    Utilize instâncias com disco cloud para cenários sensíveis ao tempo.

Procedimento

  1. Acesse a página de instâncias de cluster com sharding do ApsaraDB for MongoDB. Na barra de navegação superior, selecione um grupo de recursos e uma região. Em seguida, clique em ID da instância desejada.

  2. Na seção Shard List, altere as configurações dos shards desejados.

    • Alterar configurações de um único shard

      Na linha do shard alvo, clique em ícone 三个点 na coluna Actions. Para instâncias de pagamento conforme o uso, selecione Change configuration. Para instâncias por assinatura, selecione Upgrade ou Downgrade conforme necessário.

    • Alterar configurações de múltiplos shards

      1. Na seção Shard List, selecione os shards desejados.

      2. No canto superior esquerdo da seção Shard List, clique em Batch Reconfigure para instâncias de pagamento conforme o uso. Para instâncias por assinatura, clique em Batch Upgrade ou Batch Downgrade conforme necessário.

  3. Defina os seguintes parâmetros.

    Parâmetro

    Descrição

    Category

    Selecione a categoria de especificação da instância para o shard.

    Nota
    • Disponível apenas para instâncias baseadas em disco cloud.

    • Uma categoria fica indisponível se a zona atual não oferecer suporte a ela.

    • Para obter informações sobre as categorias e especificações de instâncias de cluster com sharding, consulte Sharded cluster instance specifications.

    Instance Specifications

    Selecione as especificações da instância para o shard.

    Storage Capacity

    Selecione a nova capacidade de armazenamento para o shard.

    Nota
    • A nova capacidade de armazenamento deve ser maior ou igual à capacidade atual do shard. Para reduzir a capacidade de armazenamento, crie uma nova instância. Para mais informações, consulte Solutions for other configuration change scenarios.

    • Após alterar o Storage Space de um shard, a nova capacidade de armazenamento se aplica a todos os nós dentro desse shard, incluindo nós somente leitura.

    Read-only Nodes

    Selecione o número de nós somente leitura após a alteração de configuração.

    Switchover Time

    Selecione quando a alteração de configuração entrará em vigor.

    • Switch Immediately after Migration: A alteração é aplicada assim que a tarefa for concluída.

    • Switch within Maintenance Window: O sistema aplica a alteração dentro da janela de manutenção especificada. Use a janela de manutenção atual ou defina uma nova.

      1. Clique em Switch within Maintenance Window ao lado de Edit para definir o horário do switchover.

      2. Na seção Specification Information, clique em Maintenance Window ao lado de Edit para definir o horário do switchover. Para mais informações, consulte Set a maintenance window.

    Nota

    Se você aumentar apenas a capacidade de armazenamento e o host de cada shard tiver recursos suficientes, o armazenamento será expandido localmente, sem migração entre máquinas físicas ou switchover. Nesse caso, a alteração entra em vigor imediatamente, sem aguardar a janela de manutenção.

  4. Conclua a compra de acordo com o método de faturamento.

    • Para instâncias de pagamento conforme o uso: Clique em Pay. O sistema deduzirá a taxa automaticamente na próxima hora.

    • Para instâncias por assinatura: Clique em Pay e siga as instruções na página Pay para concluir o pagamento.

    Durante a alteração de configuração, o status da instância será In the process of matching. A alteração estará concluída quando o status mudar para Running.

APIs relacionadas

API

Descrição

ModifyNodeSpec

Modifica as especificações de um único nó Mongos ou shard em uma instância de cluster com sharding do ApsaraDB for MongoDB.

ModifyNodeSpecBatch

Modifica as especificações de múltiplos nós Mongos ou shards em uma instância de cluster com sharding do ApsaraDB for MongoDB.