Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
MongoDB Branding Shape
Click here >
Menu Docs

Migração

Você pode migrar dados de seus sistemas locais do MongoDB para o Atlas usando um dos vários métodos. Recomendamos usar a migração live do Atlas quando possível, pois ela automatiza muitas das tarefas com o menor tempo de inatividade, mas você pode usar outras FERRAMENTAS que acomodar a variedade e complexidade inerentes à migração do banco de dados.

A migração em produção do Atlas automatiza a movimentação de dados de bancos de dados MongoDB no local para o Atlas. A migração em produção do Atlas inclui os seguintes recursos:

  • O host de migração sempre criptografa o tráfego para o Atlas cluster. O tráfego de, para e entre nós do Atlas é sempre criptografado, e esta funcionalidade não pode ser desativada. Somente usuários com funções de banco de dados específicas do Controle de Acesso Baseado em Função (RBAC) (como ,backup readAnyDatabaseou clusterMonitor) e Proprietário do Projeto Atlas podem iniciar uma migração live. Os usuários autenticam em clusters usando SCRAM-SHA-1 ou SCRAM-SHA-256.

  • A migração em produção automatiza a maioria das tarefas. Para o método "pull" totalmente gerenciado, a migração em produção monitora as principais métricas, provisiona os servidores de migração e executa o sequenciamento estrito dos comandos de migração. Além disso, você também pode selecionar as configurações de camada do cluster do Atlas de destino para as quais você gostaria de migrar.

  • Instruções detalhadas o ajudam a dimensionar clusters de destino para controlar custos. As recomendações incluem o dimensionamento adequado do cluster e realização de um escalonamento temporário, seguido de um redimensionamento para níveis ideais pós-migração.

  • A migração ao vivo usa o Mongosync nos backstend, o que facilita a transição rápida por meio da cópia paralela de dados. Os processos gerenciam interrupções temporárias de rede e eleições de cluster, usando sincronização contínua de dados e uma fase final de substituição para obter um tempo de inatividade mínimo. Mecanismos de repetição e validações de pré-migração aumentam a resiliência contra interrupções.

  • Monitore migrações com atualizações de status em tempo real e notificações.

Você pode fazer com que um servidor de migração em produção extraia dados para o Atlas. O método de migração em produção suporta caminhos de migração entre versões específicas do MongoDB. Veja Caminhos de migração suportados para aprender mais. Para migrar dados de bancos de dados usando versões não compatíveis do MongoDB, consulte Migrar ou importar dados ou Métodos manuais de migração.

  • Extraia os dados para o Atlas. O Atlas extrai dados da implantação do MongoDB de origem e requer acesso à implantação de origem por meio do firewall da implantação. Quando os clusters estiverem totalmente sincronizados, você deve seguir o processo de transição para interromper as operações de gravação na origem, redirecionar os aplicativos para o cluster do Atlas e reiniciá-los. As seguintes considerações se aplicam:

    • Mais indicado para implantações não monitoradas pelo Cloud Manager ou Ops Manager.

    • O banco de dados de origem deve estar acessível publicamente para permitir o acesso de entrada do servidor de migração em produção.

    • Não oferece suporte a emparelhamento de VPC ou pontos de extremidade privados para o cluster de origem ou de destino.

    • As topologias dos clusters de origem e destino devem corresponder. Por exemplo, ambos devem ser conjuntos de réplicas ou clusters compartilhados com o mesmo número de fragmentos.

    • Planeje para uma indisponibilidade mínima durante a transição, para interromper gravações e reiniciar os aplicativos com uma nova string de conexão. O processo de migração usa intensamente a CPU no cluster de destino e requer uma largura de banda de rede significativa.

    • Para garantir um processo de migração tranquilo, verifique se o tamanho do oplog do cluster de origem é suficiente para abranger toda a duração da migração. Para o cluster de origem, a janela de atraso da migração em produção deve permanecer dentro dos limites da janela de atraso de replicação do oplog. Você pode cumprir esse requisito aumentando a oplog window mínima ou aumentando o tamanho fixo do oplog. Para o cluster de destino, o MongoDB recomenda que você escolha uma camada do cluster de destino que esteja pelo menos a dois níveis acima do cluster de origem durante a migração. Se o dimensionamento automático de armazenamento estiver desativado no cluster de destino, aumente o tamanho do oplog no cluster de destino para um valor fixo suficientemente alto. Se o dimensionamento automático de armazenamento estiver habilitado no cluster de destino, defina uma oplog window mínima alta o suficiente no cluster de destino. Consulte Requisitos de Oplog para aprender mais.

    • Para obter recomendações e instruções completas sobre migração, consulte Migração em produção (extração) de um cluster para o Atlas.

Para revisar migrações atuais e passadas, navegue até a página Migration Hub no Atlas.

Você pode clicar em cada processo de migração para obter informações mais detalhadas, incluindo a estimativa de tempo inicial de cópia dos dados e relatórios abrangentes de progresso. Use o cartão do cluster para criar, realizar a transição ou para cancelar uma migração.

Para aprender mais, consulte Monitorar migrações.

Se a migração em produção do Atlas não puder atender aos requisitos de restrições da migração, você pode trazer dados de implantações MongoDB existentes, JSON ou arquivos CSV para o Atlas usando uma das seguintes ferramentas que você executa fora do Atlas.

Ferramenta
Descrição

O binário Mongosync é o processo primário usado pela migração ao vivo do Atlas. Você pode utilizar o mongosync autônomo para migrar dados de um cluster para um cluster no Atlas. O Atlas sincroniza dados da origem para o cluster de destino até que você transfira seus aplicativos para o Atlas cluster de destino.

Migre de um conjunto de réplicas do MongoDB para um cluster do Atlas sem desligar seu conjunto de réplicas ou aplicativos existentes. O mongomirror não importa dados de usuário/função nem copia o banco de dados do config.

Propague um cluster do Atlas com um dump de backup de dados BSON extraído do mongodump, de uma implantação existente do MongoDB. O mongorestore não restaura os dados da coleção system.profile.

Carregue dados de um arquivo JSON ou CSV em um cluster do Atlas. O mongoimport usa representação de modo estrito para determinados BSON types. Observe que o uso do mongoimport deve ser limitado a pequenos conjuntos de dados para fins de teste e/ou desenvolvimento.

Utilize uma GUI para carregar dados de um JSON ou um arquivo CSV em um Atlas cluster. Observe que o uso do MongoDB Compass deve ser limitado a pequenos conjuntos de dados para fins de teste e/ou desenvolvimento.

Você também pode restaurar dados de backup de um cluster do Atlas para outro cluster do Atlas. Para obter informações, consulte Restaure seu cluster.

Se for necessário usar configurações de emparelhamento Atlas VNet ou Private Link, você não deve permitir a conexão direta de terceiros com o cluster de origem, ou se ainda não tiver ou não quiser importar o cluster de origem no Ops Manager ou Cloud Manager, o MongoDB recomenda a abordagem autônoma de mongosync.

Se você tiver conjuntos de dados relativamente pequenos (< 300 GB) para migrar e puder arcar com o tempo de inatividade do aplicativo por um período longo, o MongoDB recomenda a abordagem mongodump e mongorestore.

Se você tiver conjuntos de dados relativamente pequenos (< 300 GB) para migrar, nenhuma preocupação com índices e pode dispor do tempo de inatividade do aplicativo por um período prolongado, o MongoDB recomenda a abordagem mongoexport e mongoimport.

Quando uma migração atingir o status "Pronta para transição", clique em Cutover on target cluster seguido por Prepare to Cutover no cartão de cluster para iniciar o processo de transição. Após a conclusão bem-sucedida da transição, reconfigure seu aplicativo para que aponte para o novo cluster de destino.

Para aprender mais, consulte Monitorar migrações.

Consulte a página Orientações para organizações, projetos e clusters do Atlas para aprender sobre os elementos estruturais do seu patrimônio empresarial Atlas ou use a navegação à esquerda para encontrar recursos e práticas recomendadas para cada pilar do Well-Architected Framework.