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 das Database Tools MongoDB, 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
You can use a queryable backup snapshot to export data for a database or a collection and restore to the target deployment. The following procedure connects to the queryable backup instance via Cloud Manager-provided tunnel [1].
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.
Select Backup Tunnel as the connection method to the queryable snapshot. [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 tiver sido exibido, selecione a organização que contém seu projeto 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.
Na barra lateral, clique em Continuous Backup sob o título Database.
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:27020Observaçã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 ou coleção do queryable backup.
- Para exportar os dados de um banco de dados,
Inclua as seguintes opções
mongodumppara se conectar ao túnel [1]: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
27020para despejar dados do banco de dadostestno diretório/mydata/restoredata/:mongodump --port 27020 --db test --out /mydata/restoredata/mongodumpgera a saída dos arquivos de banco de dadostestpara o diretório/mydata/restoredata/test/.Se o
mongodumpnão estiver em seuPATH, especifique o caminho para a ferramenta.- Para exportar os dados de uma collection,
include the following options to connect to the tunnel [1]:
--portdefinido como a porta do túnel.--dbdefinido com o nome do banco de dados a ser exportado.--collectionpara uma única collection.
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
27020despejar dados da collection derestaurantsdetestbanco de dados para/mydata/restoredata/diretório:mongodump --port 27020 \ --db test \ --collection restaurants \ --out /mydata/restoredata/mongodumpgera os dados da coleçãorestaurantsno arquivo/mydata/restoredata/test/restaurants.bson.
Utilize o mongorestore para restaurar o único banco de dados ou coleção.
- Para restaurar um único banco de dados,
Inclua as seguintes opções
mongorestore:--portdefinido para a porta do cluster de destino.--dbdefinido como o nome do banco de dados de destino.
Opcionalmente, você pode incluir
--droppara 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> --dropPor 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 --dropO 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:--portdefinido para a porta do cluster de destino.--dbdefinido como o nome do banco de dados de destino.
Opcionalmente, você pode incluir
--droppara 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> --dropPor 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 --dropO 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) Alternatively, instead of connecting via the tunnel, you can connect directly to the queryable backup, using the X.509 PEM files provided. If connecting directly to the queryable backup, you must specify the hostname and port, the TLS/SSL option, and the X.509 certificates. |
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.