Restaurar de um snapshot agendado ou on-demand
Nesta página
O Atlas permite restaurar dados de backup em nuvem agendado ou sob demanda. As seções a seguir descrevem a restauração a partir de um snapshot sem criptografia em descanso usando o gerenciamento de chaves do cliente. Para restaurar a partir de um snapshot usando criptografia em repouso usando o Gerenciamento de Chaves do Cliente, consulte Restaurar a partir de um Snapshot usando criptografia em repouso.
Restaurar considerações
Além dos pré-requisitos, considere os seguintes requisitos e limitações ao restaurar a partir de um backup em nuvem agendado ou on-demand.
Se o valor
DefaultRWConcernno snapshot de origem for diferente do valorDefaultRWConcernno cluster de destino, o Atlas substituirá o valor no snapshot de origem pelo valor no cluster de destino. Se não houver nenhum valor configurado paraDefaultRWConcernno cluster de destino, o Atlas manterá o valor deDefaultRWConcerndo snapshot sem configuração explícita. Isso pode ser diferente do valor padrão para aquela versão do MongoDB.
Esta funcionalidade não está disponível para clusters
M0.Para
M10+clusters dedicados executando MongoDB 4.2 ou superior, o Atlas restaurará as definições de índice do Atlas Search de um snapshot do Cloud Backup. O Atlas não restaura os dados de índice, então os processosmongotrealizam sincronizações iniciais para todas as definições de índice restauradas. Se tiver definido grandes índices de pesquisa no cluster, poderão ocorrer atrasos durante as restaurações de snapshots.Observação
Ao restaurar os dados do snapshot, as definições de índice do Atlas Search do snapshot substituem quaisquer definições de índice do Atlas Search existentes.
Clusters fragmentados
Se você estiver restaurando de um cluster fragmentado, os clusters de origem e de destino deverão ter o mesmo número de shards.
O Atlas não pode restaurar um snapshot de cluster fragmentado em um conjunto de réplicas.
Clusters flexíveis
Se o seu cluster foi migrado de um cluster M2 ou M5 para um cluster Flex, você terá acesso aos últimos 8 snapshots de backup desde a data da migração.
Clusters M2/M5
A partir do MongoDB 5.0, você pode restaurar snapshots de clusters que executam apenas as duas versões principais mais recentes do MongoDB para os clusters
M2eM5.Exemplo
É possível restaurar snapshots obtidos de clusters que executam o MongoDB 4.2 para um cluster
M2ouM5que executa o MongoDB 5.0.Não é possível restaurar snapshots obtidos de clusters que executam o MongoDB 4.0 para um cluster
M2ouM5que executa o MongoDB 5.0.
Instâncias sem servidor
O Atlas não pode restaurar snapshots de clusters compartilhados, clusters dedicados ou do Cloud Manager para uma instância sem servidor.
Se você estiver restaurando a partir de uma instância sem servidor, só poderá restaurar os dois snapshots mais recentes.
Recomendações para otimizar o tempo de restauração
Para otimizar o desempenho e reduzir o tempo necessário para a restauração, siga estes princípios quando aplicável:
Selecione um cluster de destino que não seja global ou multinuvem.
Selecione um cluster multirregional somente se existirem cópias do snapshot que você planeja restaurar em todas as regiões desse cluster.
Selecione um cluster de destino que pertença ao mesmo projeto do Atlas e à mesma região do fornecedor de nuvem que do snapshot.
Selecione uma camada de cluster com a mesma capacidade de armazenamento que a capacidade do volume original usado pelo cluster de origem.
Se o cluster de destino for executado na AWS com IOPS configurado, selecione o IOPS configurado para estar dentro da faixa configurada.
Selecione um cluster que não esteja configurado para usar armazenamento NVMe . O armazenamento NVMe degrada o desempenho da restauração.
Snapshots substitutos
Se um snapshot agendado falhar por qualquer motivo, o Atlas tentará repetir o processo de snapshot. Se necessário, você poderá usar o snapshot de fallback resultante para restaurar o cluster. Isto não é recomendado: os snapshots de fallback usam um processo diferente dos snapshots regulares. Eles podem conter dados inconsistentes.
Os snapshots de fallback são marcados na UI com um ícone de aviso e uma mensagem de aviso aparece na janela modal de restauração se a restauração usar um snapshot de fallback.
Aviso
Restaurar o cluster a partir de um snapshot de fallback pode resultar em dados inconsistentes em todo o cluster e deve ser considerado uma opção de último recurso.
Acesso necessário
Para iniciar um trabalho de restauração, você deve ter acesso ao Project Owner ou superior ao projeto.
Para assistir a uma tarefa de restauração de backup até que ele seja concluído, você deve ter acesso Project Read Only ou superior ao projeto.
Procedimento
O Atlas exclui todos os dados existentes no cluster de destino antes da restauração. Dependendo do tipo de restauração que está ocorrendo, o cluster de destino poderá ficar indisponível durante o processo.
Restaurar um cluster
Para iniciar uma tarefa de restauração para seu projeto e cluster usando o Atlas CLI, execute o seguinte comando:
atlas backups restores start <automated|download|pointInTime> [options]
Para observar se um trabalho de restauração específico deve ser concluído usando o Atlas CLI, execute o seguinte comando:
atlas backups restores watch <restoreJobId> [options]
Para saber mais sobre a sintaxe e os parâmetros dos comandos anteriores, consulte a documentação da CLI do Atlas para atlas backups restores start e o atlas backups restores watch.
Restaurar uma instância sem servidor
Para iniciar uma tarefa de restauração para sua instância sem servidor usando o Atlas CLI, execute o seguinte comando:
atlas serverless backups restores create [options]
Para observar a tarefa de restauração de backup especificada até que ela seja concluída usando o Atlas CLI, execute o seguinte comando:
atlas serverless backups restores watch [options]
Para saber mais sobre a sintaxe e os parâmetros dos comandos anteriores, consulte a documentação da CLI do Atlas para Atlas CLI serverless backups restores create e Atlas CLI serverless backups restores watch.
A API de administração do Atlas fornece endpoints diferentes para restaurar clusters M10+ , clusters M2/M5 e instâncias sem servidor.
Restaurar um snapshot de um cluster Criar uma tarefa de restauração a partir de um cluster M2 ou M5 Restaurar um snapshot de uma instância sem servidor
Restaurar um cluster
No Atlas, acesse a Clusters página 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.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Acesse a Backup página do seu cluster.
Clique no nome do seu cluster.
Clique na aba Backup.
Se o cluster não tiver a guia Backup , os backups do Atlas serão desabilitados para este cluster e nenhum snapshot estará disponível. Você pode habilitar backups ao escalar o cluster.
A página Backup é exibida.
Selecione o snapshot a ser restaurado e clique em Restore.
Na coluna Actions, expanda o menu Actions e clique em Restore para o snapshot que você deseja restaurar.
Na janela modal, selecione o cluster de destino no menu suspenso.
Siga o prompt e clique em Restore.
Reinicie seu aplicativo e certifique-se de que ele use o novo cluster de destino.