Importante
O recurso descrito nesta página não é suportado atualmente em cluster Atlas Infinite durante a visualização pública. Para os recursos suportados na visualização pública, consulte Disponibilidade de Visualização Pública.
Observação
Se você estiver executando uma implantação autogerenciada, consulte Transição do servidor de configuração incorporado para dedicado para aprender como fazer a transição do tipo de servidor de configuração usando o comando de banco de dados transitionToDedicatedConfigServer.
Quando um cluster fragmentado usa um servidor de configuração incorporado, chamado de shard de configuração, o Atlas ou um usuário pode fazer a transição do cluster para usar um servidor de configuração dedicado. Com um servidor de configuração incorporado, o fragmento de configuração armazena metadados de cluster e dados de usuário. Com um servidor de configuração dedicado, o nó de configuração armazena somente metadados. O Atlas faz a transição de clusters de servidores de configuração incorporados para dedicados automaticamente sob determinadas condições. Você também pode iniciar a transição manualmente.
Antes de começar
A transição de um servidor de configuração dedicado é uma operação online que requer a transferência de todos os dados do usuário para fora do fragmento de configuração. Para clusters com grandes quantidades de dados no fragmento de configuração, o processo pode levar de horas a dias. Antes de iniciar a transição, confirme o seguinte:
Seus fragmentos de destino têm headroom. Durante a migração, os fragmentos que recebem dados do fragmento de configuração veem CPU, memória e E/S elevadas. Enquanto a transição é executada, o Atlas não pode dimensionar a camada do cluster ou modificar o armazenamento porque somente um plano de longa duração pode ser executado por vez. Se os shards de recebimento estiverem próximos da capacidade, dimensione-os antes de iniciar a transição.
Seu cluster usa apenas funcionalidades compatíveis. MongoDB Search, MongoDB Vector Search, coleções de séries temporais não fragmentadas e coleções de Queryable Encryption não fragmentadas no config shard bloqueiam transições automáticas. Para obter uma lista completa dos recursos de bloqueio, consulte Limitações e exceções.
descartar
system.profileantes de fazer a transição em versões anteriores do MongoDB . A coleção system.profile no fragmento de configuração pode bloquear a transição. Se o perfil estiver ativado, descartarsystem.profileantes de iniciar a transição ou atualize para o MongoDB 8.2.7 ou posterior.O bloqueio de gravar não deve estar ativo no servidor de configuração. Se o bloqueio de gravação estiver ativo no servidor de configuração, o Atlas não permitirá a transição para um servidor de configuração dedicado. O Atlas exibe um banner na página do cluster indicando que a transição está bloqueada enquanto o bloqueio de gravar estiver ativo. Para continuar, aumente o armazenamento do cluster ou habilite o dimensionamento automático de armazenamento para limpar a condição de bloqueio de gravação e, em seguida, tente a transição novamente.
Iniciar a transição
O Atlas gerencia automaticamente as transições entre os servidores de configuração incorporados e dedicados quando os Servidores de Configuração Gerenciados pelo Atlas estão ativados. O diagrama a seguir mostra quando o Atlas aciona cada transição:
Transições Gerenciadas pelo Atlas
O Atlas habilita servidores de configuração gerenciados pelo Atlas por padrão para todos os clusters 8.0. Quando ativado, o Atlas transita automaticamente seu cluster entre tipos de servidor de configuração com base na contagem de fragmentos:
Quando a contagem de fragmentos aumenta além de 10, o Atlas faz a transição de um servidor de configuração incorporado para um servidor de configuração dedicado.
Quando a contagem de fragmentos diminui para 10 ou menos, o Atlas faz a transição de um servidor de configuração dedicado para um servidor de configuração incorporado.
Observação
Ao atualizar um cluster do MongoDB 7.0 para 8.0, o Atlas ativa os servidores de configuração gerenciados pelo Atlas, mas não altera o tipo de servidor de configuração existente do cluster. A partir do MongoDB 8.0, Os servidores de configuração gerenciados pelo Atlas estão ativados por padrão, e esses critérios se aplicam apenas a alterações na contagem de shards. Para mover um cluster para um servidor de configuração incorporado, entre em contato com o Suporte do MongoDB.
Faça a transição manual para o servidor de configuração dedicado
Para manualmente trigger a transição para um servidor de configuração dedicado, complete as seguintes etapas:
No Atlas, vá para a página Clusters do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Clusters sob o título Database.
A página Clusters é exibida.
Desative o botão Atlas-Managed Configuration Servers.
Em Additional Settings > More Configuration Options, desative o botão Atlas-Managed Configuration Servers.
Durante a transição
O MongoDB não pode mover metadados de configuração, portanto, o Atlas deve primeiro drenar todos os dados do usuário do fragmento de configuração, config-0, antes de fazer a transição para um servidor de configuração dedicado. Como parte da transição, o Atlas adiciona um fragmento de substituição para manter sua contagem de fragmentos de destino porque config-0 não serve mais dados do usuário.
Exemplo de processo de transição
A tabela a seguir mostra as etapas que o Atlas executa quando você adiciona um 11º shard a um cluster de 10-shard com Servidores de Configuração Gerenciados pelo Atlas habilitados, o que inicia a transição.
etapa | em ação | Contagem de fragmentos efetiva |
|---|---|---|
Iniciar | Cluster de shard 10 com servidor de configuração incorporado ( | 10 |
1 | O Atlas adiciona | 11 |
2 | O Atlas executa o | 11 (drenagem em andamento) |
3 | O Atlas espera que | 11 ( limpeza em andamento) |
4 |
| 11 |
5 | O Atlas reduz | 11 |
duração
A duração da transição depende da quantidade de dados do usuário no fragmento de configuração. A drenagem do fragmento de configuração envolve migrações de blocos para coleções fragmentadas e operações moveCollection para coleções não fragmentadas, ambas as quais movem dados pela rede. A duração varia de acordo com o tamanho do datasets:
datasets pequenos (alguns GB): minutos a um pequeno número de horas
Large datasets (hundreds of GB to multiple TB): horas a dias
Observação
Se o seu cluster tiver um grande volume de dados no fragmento de configuração, execute a transição durante um período de baixo tráfego.
Impacto operacional
A transição de um servidor de configuração dedicado tem os seguintes impactos operacionais em seu cluster:
Sem tempo de inatividade. A transição é online. Seu aplicativo continua lendo e gravando por toda parte.
Uso elevado de recursos no recebimento de fragmentos. Os fragmentos que consomem dados do fragmento de configuração podem ver CPU, memória e E/S mais altas durante a migração. A latência do aplicativo em fragmentos afetados pode aumentar discretamente.
Atlas plan bloqueio. Enquanto a transição é executada, o Atlas não pode executar outros planos de longa duração no cluster, como dimensionar a camada do cluster, alterar o armazenamento ou adicionar ou remover outros fragmentos. Somente um plano de longa duração pode ser executado por vez.
Aviso
Não cancele a transição após ela ter começado.
Não cancele por meio da IU do Atlas ou reduzindo a contagem de fragmentos enquanto a transição estiver em andamento. Se o cancelamento for necessário, entre em contato com o Suporte MongoDB.
Monitore o progresso
O diagrama a seguir mostra os métodos disponíveis para monitorar o progresso da transição:
Enquanto a transição está em andamento, o Atlas exibe o seguinte banner na página do cluster:
We are deploying your changes (current action: transitioning config server type).
Limitações e exceções
O Atlas não faz transição automática de servidores de configuração para clusters que usam as seguintes funcionalidades. Se o seu cluster usar uma dessas funcionalidades e precisar de uma alteração no tipo de servidor de configuração, entre em contato com o suporte da MongoDB:
funcionalidade | Transição automática | de conflitos |
|---|---|---|
MongoDB Search / pesquisa vetorial O Atlas define o tipo de servidor de configuração como era quando a Pesquisa foi ativada. A restrição se aplica a coleções fragmentadas e não fragmentadas. | Bloqueado (fixado) | Entre em contato com o suporte do MongoDB ou faça a migração em produção |
Queryable Encryption não fragmentada
| Bloqueado | Entre em contato com o suporte MongoDB |
Global Clusters Não ofereça suporte a servidores de configuração incorporados. | N/A | Sempre dedicado |
Conjunto de réplica para conversão de cluster fragmentado Quando você converte um conjunto de réplicas em um cluster fragmentado no Atlas, o cluster resultante sempre usa um servidor de configuração dedicado, independentemente da configuração Atlas-Managed Configuration Servers. | N/A | Entre em contato com o suporte MongoDB |
Nenhuma das opções acima | Permitido | Proceeds online |