Menu Docs
Página inicial do Docs
/
MongoDB Cloud Manager
/ /

Restaurar um único banco de dados ou coleção

Nesta página

  • Considerações
  • Restaurar um banco de dados ou collection do Queryable backup

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.

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

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].

1

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 .

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

  2. Start o processo para query um instantâneo. Você será solicitado a fazer a verificação de dois fatores.

  3. Selecione Backup Tunnel como o método de conexão para o instantâneo consultável. [1]

  4. Selecione sua Plataforma e faça o download.

  5. 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:

    1. No MongoDB Cloud Manager, Go a página Continuous Backup do seu projeto.

      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 Projects na barra de navegação.

      3. Clique em Continuous Backup na barra lateral.

      A página Backup contínuo é exibida.

    2. Selecione a guia Restore History.

    Quando o snapshot é montado, a coluna Status informa a data e a hora da operação de montagem.

  6. 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.

3
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 dados test no diretório /mydata/restoredata/ :

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

mongodump gera a saída dos arquivos de banco de dados test para o diretório /mydata/restoredata/test/.

Se o mongodump não estiver em seu PATH, 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 de restaurants de test banco de dados para /mydata/restoredata/ diretório:

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.

4
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.

5

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

  1. Vá até Restore History e paire sobre a coluna Status para o item de sistema.

  2. Clique em Cancel.

[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.

Voltar

Fazer query de um snapshot