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.
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 3, 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 3 ou menos, o Atlas faz a transição de um servidor de configuração dedicado para um servidor de configuração incorporado.
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 quarto fragmento a um cluster de fragmentos 3com 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 fragmento 3com servidor de configuração incorporado ( | 3 |
1 | O Atlas adiciona | 4 |
2 | O Atlas executa o | 4 (drenagem em andamento) |
3 | O Atlas espera que | 4 ( limpeza em andamento) |
4 |
| 4 |
5 | O Atlas reduz | 4 |
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 |
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 |