Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/ /

Restaurar uma collection de um Queryable backup legado

Nesta página

  • Pré-requisitos
  • Procedimento

Importante

Backup legado obsoleto

A partir de 23 de março de 2020, todos os novos clusters poderão somente usar backups em nuvem.

Quando você faz upgrade para a versão 5.0, seu sistema de backup faz upgrade para o backup na nuvem, caso esteja atualmente definido como backup legado. Após esta atualização:

  • Todos os seus snapshots de backup legado existentes permanecem disponíveis. Eles expiram ao longo do tempo de acordo com a suapolítica de retenção .

  • Sua política de backup é redefinida para o agendamento padrão. Se você tiver uma política de backup personalizada em vigor com backups legados, deverá recriá-la com o procedimento descrito na documentação do Cloud Backup.

O Atlas suporta a restauração de uma coleção consultando um snapshot de backup legado .

Importante

Atlas não suporta a consulta de backups cloud.

Você pode usar um queryable backup para exportar dados para uma collection e restaurar para o sistema de destino. O procedimento a seguir se conecta à queryable backup por meio de um túnel fornecido pelo Atlas.

Você deve garantir que o cluster do Atlas de destino não receba solicitações de clientes durante a restauração. Os seguintes casos de uso se aplicam:

  • Se você planeja restaurar no mesmo reconhecimento de data center, deve interromper as operações do cliente durante a restauração.

  • Se você planeja restaurar em um reconhecimento de data center diferente, não precisa interromper a aplicação do cliente. Nesse caso, você pode restaurar em um novo cluster do Atlas e reconfigurar seu aplicativo para usar esse novo cluster assim que o novo sistema estiver em execução.

1
  1. Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Project na barra de navegação.

  3. Clique em Legacy Backup na barra lateral.

2

A aba Overview na página Legacy Backup lista os clusters do projeto.

  • Se o backup estiver habilitado para o cluster, o Status será Active.

  • Se o backup estiver desabilitado para o cluster, o Status será Inactive.

Para o sistema cujo backup você deseja fazer query, clique nas reticências na coluna Options e selecione Query.

Você também pode clicar em View All Snapshots para visualizar seus snapshots e clicar em Query na coluna Actions para o snapshot desejado.

3
  1. Selecione o snapshot para query e clique em Next.

  2. Start o processo para query um instantâneo. Você será solicitado para inserir sua senha do Atlas.

  3. Selecione Backup Tunnel como o método de conexão para o snapshot consultável.

  4. Selecione seu Platform.

  5. Clique em Download Backup Tunnel.

  6. Descompactar o arquivo baixado.

  7. Abra um terminal ou prompt de comando e vá para o diretório <tunnel> descompactado. Execute o executável para iniciar o túnel.

    A porta padrão para o túnel é 27017. Para alterar a porta, use o sinalizador --local, como no exemplo a seguir:

    ./<tunnel executable> --local localhost:27020

    Observação

    Se você alterar a porta, deverá incluir as informações da porta ao se conectar.

4
Para exportar os dados de uma collection:

Inclua as seguintes opções para se conectar ao túnel:

  • --port definido como a porta do túnel.

  • --db definido com o nome do banco de dados a ser exportado.

  • --collection definido com o nome da collection a ser exportada.

  • --out definido como um diretório vazio para gerar o despejo de dados.

    Importante

    Certifique-se de que o usuário que executa o mongodump possa gravar no diretório especificado.

mongodump --port <port for tunnel> --db <single-database> --collection <collection-name> --out <data-dump-path>

Por exemplo, para conectar-se a um túnel em execução na porta 27020 para despejar dados da restaurants coleção do test banco de dados para o diretório /mydata/restoredata/ :

mongodump --port 27020 --db test --collection restaurants --out /mydata/restoredata/

mongodump gera os dados da coleção restaurants no arquivo /mydata/restoredata/test/restaurants.bson.

5
Para restaurar uma única collection:

Inclua as seguintes opções mongorestore:

Observação

Para restaurar para um cluster do Atlas, recomendamos que você se conecte com uma lista de sementes de DNS utilizando a opção --uri .

  • --uri definido como a string de conexão do cluster de destino.

  • --db definido como o nome do banco de dados de destino.

  • --collection definido como o nome da collection de destino.

Opcionalmente, você pode incluir a opção --drop para descartar a collection no cluster de destino se a collection já existir.

mongorestore --uri "mongodb+srv://username:password@cluster0.example.mongodb.net" --db <destination-database> --collection <destination-collection> <data-dump-path/dbname/collection.bson> --drop

Por exemplo, para restaurar a partir do arquivo de dados /mydata/restoredata/test/restaurants.bson para uma nova coleção rest2 no banco de dados test2:

mongorestore --uri "mongodb+srv://username:password@cluster0.example.mongodb.net" --db test2 --collection rest2 /mydata/restoredata/test/restaurants.bson --drop
6

Depois de terminar, você pode encerrar a instância que pode ser analisada:

  1. Clique em Legacy Backup no painel de navegação esquerdo e clique na guia Restores & Downloads .

  2. Passe o mouse sobre a coluna Status do item de sistema de destino e clique em Cancel.

  3. Clique em Cancel Restore Job.

7

Reinicie seu aplicativo e certifique-se de que ele use o novo cluster de destino.

Voltar

Restaurar um banco de dados