Restaurar um único banco de dados ou coleção
- A autenticação OAuth 2.0 para acesso programático ao Cloud Manager está disponível como um recurso de visualização.
- O recurso e a documentação correspondente podem mudar a qualquer momento durante o período de Pré-visualização. Para usar a 2.0 autenticação OAuth, crie uma conta de serviço para usar em suas solicitações para a API pública do Cloud Manager .
Para restaurar um único database ou uma coleção (ou documentos específicos) a partir de um snapshot, você pode usar o Backup Consultável para exportar um único database ou coleção para restaurar na implantação de destino.
Considerações
Antes de tentar uma restauração, certifique-se de que o host da implantação de destino tenha espaço de armazenamento suficiente para os arquivos de restauração e o banco de dados restaurado, além de espaço adicional para crescimento do conjunto de dados. Use db.stats() para encontrar o tamanho atual do banco de dados.
Importante
Use as versões mais recentes do MongoDB Database Tools, que incluem mongodump
e mongorestore
. Use a versão mais recente do mongosh
.
As versões mais antigas de mongodump
incluem um problema que pode fazer com que as chaves nas opções de collection sejam despejadas na ordem errada. Para saber mais, consulte FERRAMENTAS-3411.
Restaurar um banco de dados ou collection do Queryable backup
Você pode usar um queryable backup snapshot para exportar dados de um banco de dados ou de uma collection e restore para o sistema de destino. O procedimento a seguir se conecta à instância de queryable backup por meio do túnel fornecido pelo Cloud Manager [1].
VáGo para Backup exibição e Overview clique na guia.
Para o sistema consumidor cujo backup você deseja fazer query, clique em na coluna Options então selecione Query.
Você também pode clicar no sistema para visualizar suas capturas de imagem e clicar no botão Query na coluna Actions .
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 a fazer a verificação de dois fatores.
Selecione Backup Tunnel como o método de conexão para o instantâneo consultável. [1]
Selecione sua Plataforma e faça o download.
Descompactar o arquivo baixado.
Observação
Aguarde a montagem do Queryable Snapshots antes de continuar. O tempo de montagem do snapshot depende do tamanho do snapshot. Para verificar se o snapshot está montado:
No MongoDB Cloud Manager, Go a página Continuous Backup 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 Projects na barra de navegação.
Clique em Continuous Backup na barra lateral.
A página Backup contínuo é exibida.
Selecione a guia Restore History.
Quando o snapshot é montado, a coluna Status informa a data e a hora da operação de montagem.
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 um único banco de dados de dados ou collection do queryable backup.
- Para exportar os dados de um banco de dados,
Inclua as seguintes opções
mongodump
para se conectar ao túnel [1]:--port
configurar para a porta do túnel--db
configurar para o nome do banco de dados para exportar--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> Exemplo
Para conectar-se a um túnel em execução na porta
27020
para despejar dados do banco de dadostest
no diretório/mydata/restoredata/
: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 o
mongodump
não estiver em seuPATH
, especifique o caminho para a ferramenta.- Para exportar os dados de uma collection,
incluir as seguintes opções para se conectar ao túnel [1]:
--port
definido como a porta do túnel.--db
definido com o nome do banco de dados a ser exportado.--collection
para uma única collection.--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> Exemplo
Para conectar-se a um túnel em execução na porta
27020
despejar dados da collection derestaurants
detest
banco de dados para/mydata/restoredata/
diretório:mongodump --port 27020 \ --db test \ --collection restaurants \ --out /mydata/restoredata/ mongodump
gera os dados da coleçãorestaurants
no arquivo/mydata/restoredata/test/restaurants.bson
.
Utilize mongorestore
o para restaurar o único banco de dados de dados ou coleção.
- Para restaurar um único banco de dados,
Inclua as seguintes opções
mongorestore
:--port
definido para a porta do cluster de destino.--db
definido como o nome do banco de dados de destino.
Opcionalmente, você pode incluir
--drop
para descartar o banco de dados no cluster de destino se o banco de dados já existir.
mongorestore --port <port> --db <destination database> <data-dump-path/database> --drop
Por exemplo, para restaurar a partir do diretório /mydata/restoredata/test
para um novo banco de dados restoredTest
:
mongorestore --port 27017 --db restoredTest /mydata/restoredata/test --drop
O exemplo pressupõe que o mongos
da réplica primária do conjunto de réplicas de destino ou do cluster fragmentado de destino escuta na porta 27017
.
- Para restaurar uma única collection,
Inclua as seguintes opções
mongorestore
:--port
definido para a porta do cluster de destino.--db
definido como o nome do banco de dados de destino.
Opcionalmente, você pode incluir
--drop
para descartar a coleção no cluster de destino se a coleção já existir.
mongorestore --port <port> --db <destination database> --collection <collection-name> <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 --port 27017 --db test2 --collection rest2 /mydata/restoredata/test/restaurants.bson --drop
O exemplo pressupõe que o mongos
da réplica primária do conjunto de réplicas de destino ou do cluster fragmentado de destino escuta na porta 27017
.
[1] | (1, 2, 3, 4) Como alternativa, em vez de se conectar pelo túnel, você pode se conectar diretamente ao queryable backup, usando os arquivos PEM X.509 fornecidos. Se estiver se conectando diretamente ao queryable backup, você deverá especificar o nome do host e a porta, a opção TLS/SSL e os certificados X.509. |
Importante
Girar chave-mestra após restaurar snapshots criptografados com AES256-GCM
Se você restaurar um snapshot criptografado que o Cloud Manager criptografou com AES256-GCM, gire sua chave mestra após concluir a restauração.