Importante
A funcionalidade descrita nesta página não é atualmente suportada em clusters Atlas Infinite durante a visualização pública. Para os recursos suportados na visualização pública, consulte Disponibilidade da visualização pública.
Observação
Se você estiver executando uma implantação autogerenciada, consulte Transição de servidor de configuração incorporado para dedicado para aprender como fazer a transição do seu tipo de servidor de configuração usando o transitionToDedicatedConfigServer comando de banco de dados.
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 shard 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 compartilhadas e coleções de queryable encryption não compartilhadas nas transições automáticas do bloco de shards de configuração. 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 habilitado, soltesystem.profileantes de iniciar a transição ou atualize para MongoDB..8 27 ou posterior.O bloqueio de gravação 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 gravação está ativo. Para continuar, aumente o armazenamento do cluster ou habilite o auto-scaling do armazenamento para limpar a condição de bloqueio de escrita e, em seguida, tente novamente a transição.
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 5, 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 5 ou menos, o Atlas faz a transição de um servidor de configuração dedicado para um servidor de configuração incorporado.
Observação
Quando você atualiza um cluster fragmentado 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. Começando com o MongoDB 8.0, os servidores de configuração gerenciados pelo Atlas estão ativados por padrão, e esses critérios se aplicam somente às alterações de contagem de shards. Para mover um cluster para um servidor de configuração incorporado, entre em contato com o Suporte 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 sexto shard a um 5cluster de shards 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 5com servidor de configuração incorporado ( | 5 |
1 | O Atlas adiciona | 6 |
2 | 6 (drenagem em andamento) | |
3 | O Atlas espera que passe antes de confirmar | 6 ( limpeza em andamento) |
4 |
| 6 |
5 | O Atlas reduz | 6 |
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 UI do Atlas ou reduzindo a contagem de shards 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 do 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 live |
Série temporal não fragmentada O MongoDB Server suspendeu a restrição subjacente na versão 8.0.10, mas o Atlas ainda não adotou essa alteração. | Bloqueado | Entre em contato com o suporte MongoDB |
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 |