Restaurar uma collection de um Queryable backup legado
Nesta página
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.
Observação
Você deve ter a função Project Owner
para o projeto Atlas que contém os clusters de origem e destino do Atlas para restaurar dados de um cluster do Atlas para outro.
Pré-requisitos
Operações do cliente durante a restauração
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.
Procedimento
Navegue até a Legacy Backup página do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Project na barra de navegação.
Clique em Legacy Backup na barra lateral.
Selecione o snapshot para query.
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.
Abra um túnel de backup para o snapshot consultável.
Selecione o snapshot para query e clique em Next.
Start o processo para query um instantâneo. Você será solicitado para inserir sua senha do Atlas.
Selecione Backup Tunnel como o método de conexão para o snapshot consultável.
Selecione seu Platform.
Clique em Download Backup Tunnel.
Descompactar o arquivo baixado.
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.
Use mongodump
para exportar uma collection única do queryable backup.
- 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 darestaurants
coleção dotest
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çãorestaurants
no arquivo/mydata/restoredata/test/restaurants.bson
.
Use mongorestore
para restaurar a coleção única.
- 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
Termine a instância consultável.
Depois de terminar, você pode encerrar a instância que pode ser analisada:
Clique em Legacy Backup no painel de navegação esquerdo e clique na guia Restores & Downloads .
Passe o mouse sobre a coluna Status do item de sistema de destino e clique em Cancel.
Clique em Cancel Restore Job.