Fazer query de um snapshot de backup
Nesta página
- 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 .
O Cloud Manager fornece queryable backup. Essa funcionalidade permite query mais rapidamente snapshots de backup específicos. Você pode usar o queryable backup para:
Restaure um subconjunto de dados dentro da implantação MongoDB.
Compare as versões anteriores dos dados com os atuais.
Identifique o melhor ponto no tempo para restaurar um sistema comparando dados de vários instantâneos.
Considerações
Instância somente leitura
O Cloud Manager provisiona esses snapshots consultáveis como instâncias MongoDB somente para leitura .
Importante
Essas instâncias estão disponíveis por até 24 horas.
Restrições de query nos snapshots que podem ser consultados
Não é possível executar as seguintes operações em snapshots consultáveis:
Queries que exigem uso de disco, como executar aggregation com a opção
allowDiskUse
para executar operações de classificação grandes.
Não é possível query snapshots criptografados
Se você criptografou seus snapshots, não poderá consultá-los.
Não é possível consultar snapshots filtrados do namespace
Se você aplicou filtros de namespace a um snapshot, não será possível consultá-lo.
Métodos de conexão
As conexões com essas instâncias são feitas por TLS/SSL e exigem x. Autenticação 509 . O Cloud Manager fornece:
Um executável que cria um túnel que lida com a conexão, incluindo o cliente TLS/SSL e o x. Autenticação 509 .
x.509 se você quiser manipular os detalhes da conexão manualmente, incluindo o TLS/SSL e a autenticação x.509.
Pré-requisitos
queryable backup estão disponíveis para conjuntos de réplicas do MongoDB 3.2 ou posterior ou do MongoDB 3.2 ou clusters fragmentados com CSRS.
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.
Backup de query (usar túnel para conectar)
Observação
O túnel lida com a segurança (autenticação TLS/SSL e x.509) para conexão com a instância.
VáGo para Backup exibição e Overview clique na guia.
Para o sistema cujo backup você deseja consultar, clique no botão de reticências na coluna Options e selecione Query.
Você também pode clicar no sistema para visualizar suas capturas de imagem e clicar no botão Query na coluna Actions .
Siga as instruções para consultar um snapshot do backup.
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 snapshot consultável.
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.
Para a lista completa de opções que você pode passar para o túnel, execute o túnel que pode ser examinado com a opção
-h
:./<tunnel executable> -h Use
mongosh
ou um driver MongoDB para se conectar ao backup por meio do túnel.Se conectar localmente a partir da mesma máquina de onde o túnel está em execução, você não precisará especificar uma connection string ou informações do host. Caso contrário, especifique uma connection string ou informações de host para a máquina onde o túnel está sendo executado.
Se você alterou a porta em que o túnel está escutando, especifique as informações da porta ao se conectar.
Dica
Depois de terminar de consultar esse snapshot, você poderá encerrar a instância consultável:
Vá até Restore History e paire sobre a coluna Status para o item de sistema.
Clique em Cancel.
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.
Backup de query (manipular a autenticação TLS manualmente)
Observação
Os certificados X.509 são válidos por 24 horas.
AcesseGo a Backup visualização e Overview clique na aba.
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 .
Siga as instruções para consultar um snapshot do backup.
Selecione o snapshot para query e clique em Next.
Start o processo para executar query de um snapshot. Se sua senha for solicitada, digite-a para verificar.
Selecione Connect Manually como o método de conexão para o snapshot consultável.
Baixe o arquivo PEM do cliente X.509.
Baixe o arquivo PEM da Autoridade de certificação.
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.
Use
mongosh
ou um driver MongoDB para se conectar ao host de queryable backup que pode ser consultado. Para conectar, você deve especificar o nome do host e a porta, a opção TLS e os certificados X.509 .Exemplo
Se estiver usando
mongosh
para se conectar à instância:mongosh my-queryable-backup-host.mongodb.com:27217 \ --tls --tlsCertificateKeyFile <client certificate> \ --tlsCAFile mms-backup-ca.pem
Dica
Depois de terminar de consultar esse snapshot, você poderá encerrar a instância consultável:
Vá até Restore History e paire sobre a coluna Status para o item de sistema.
Clique em Cancel.
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.
Próximos passos
Para restaurar um banco de dados ou uma collection usando a instância de queryable backup do MongoDB, consulte Restaurar um banco de dados ou uma collection do queryable backup.