Restaurar um reconhecimento de data center do Queryable legado Backup
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 legados 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.
Atlas suporta a restauração de um reconhecimento de data center 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 um reconhecimento de data center 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
Importante
Você deve interromper as operações do cliente somente durante a restauração, quando restaurar o mesmo reconhecimento de data center.
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.
Utilize mongodump
o para exportar um único banco de dados a partir da cópia de segurança consultável.
- Para exportar os dados de um reconhecimento de data center:
Inclua as seguintes opções de
mongodump
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.--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> --out <data-dump-path> Por exemplo, para conectar-se a um túnel em execução na porta
27020
para despejar dados dotest
reconhecimento de data/mydata/restoredata/
center :mongodump --port 27020 --db test --out /mydata/restoredata/ mongodump
gera a saída dos arquivos de banco de dadostest
para o diretório/mydata/restoredata/test/
.Se
mongodump
não estiver em seu$PATH
, especifique o caminho da ferramenta ao executar o comando.
Use mongorestore
para restaurar o único banco de dados.
- Para restaurar um único reconhecimento de data center:
Inclua as seguintes opções
mongorestore
:Observação
Para restaurar para um cluster do Atlas, recomendamos que você se conecte com uma string de conexão da lista de sementes de DNS usando 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.
Observação
Se sua senha contiver caracteres especiais, ela deverá ser codificada por porcentagem.
Opcionalmente, você pode incluir a opção
--drop
para descartar o reconhecimento de data center no cluster de destino se o reconhecimento de data center já existir.
mongorestore --uri "mongodb://username:password@mongodb0.example.com:<Port>,mongodb1.example.com:<Port1>,mongodb2.example.com:<Port2>" --ssl --db <destination database> <data-dump-path/database> --drop
mongorestore --uri "mongodb+srv://username:password@cluster0.example.mongodb.net" --db <destination database> <data-dump-path/database> --drop
Observação
Se estiver usando mongodump
ou mongorestore
no Ubuntu 18.04, você poderá enfrentar uma mensagem de erro cannot unmarshal DNS
ao usar connection strings SRV (no formato mongodb+srv://
) com a opção --uri
. Nesse caso, use uma das seguintes opções:
a opção
--uri
com uma connection string não SRV (no formatomongodb://
)a opção
--host
para especificar o host para conectar diretamente
Por exemplo, para restaurar a partir do diretório /mydata/restoredata/test
para um novo banco de dados restoredTest
:
mongorestore --uri "mongodb://username:password@00.foo.mongodb.net:27017,01.foo.mongodb.net:27017,02.foo.mongodb.net:27017" --ssl --db restoredTest /mydata/restoredata/test --drop
O exemplo pressupõe que o mongos primário do conjunto de réplicas de destino ou do cluster sharded de destino escuta na porta 27017
.
mongorestore --uri "mongodb+srv://username:password@cluster0.example.mongodb.net" --db restoredTest /mydata/restoredata/test --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.