Restaurar um banco de dados

Passo a passo para selecionar um backup e restaurar em uma instalação PostgreSQL.

A tela Restaurar o Banco de Dados permite recuperar um banco a partir de um arquivo local ou de um backup baixado pelo Seletor Online. Ela também concentra a criação de banco em branco, execução de script SQL, Multi-restauração, QueryConsole e o modo Dump.

Para que serve

Use esta tela quando precisar:

• restaurar um backup em um PostgreSQL local ou acessível pela rede;
• baixar um backup pelo Seletor Online e restaurar em seguida;
• criar um banco vazio para preparar uma instalação;
• executar um script SQL em um banco informado;
• exportar um banco com a opção Dump.

Antes de começar

• Tenha o arquivo de backup correto.
• Confirme o nome do banco de destino.
• Confira a porta do PostgreSQL.
• Verifique se a restauração pode substituir um banco existente.
• Separe a senha do PostgreSQL e, se o arquivo for compactado, a senha do arquivo.
• Feche sistemas que possam estar usando o banco de destino.

Como acessar

1. Abra o RestauraDB.
2. Na tela principal, clique em Restaurar o Banco de Dados.

Ampliar

Campos principais

Host

Informe onde o PostgreSQL está sendo executado. Na maioria das instalações locais, use localhost.

Porta

Informe a porta do PostgreSQL. Se houver mais de uma versão instalada, confirme a porta correta antes de restaurar.

Banco de Dados

Informe o nome do banco que será criado, restaurado ou substituído.

Arquivos aceitos

O RestauraDB trabalha com arquivos como .bkp, .backup, .dump, .sql, .zip, .rar e .tgz.

• Use .zip, .rar ou .tgz quando o backup estiver compactado.
• Use .sql quando a tarefa for executar um script pela opção Roda Script.
• Use .backup ou .dump quando o arquivo veio de uma exportação PostgreSQL.
• Se o arquivo veio do Seletor Online, aguarde o download terminar antes de iniciar.

Como fazer

1. Preencha Host, Porta e Banco de Dados.
2. Clique em Selecionar Arquivo.
3. Escolha o arquivo de backup.
4. Confira o banco de destino.
5. Clique em Iniciar Restauração.
6. Se o RestauraDB pedir confirmação para substituir um banco existente, confirme somente se tiver certeza.
7. Aguarde o andamento na tela.

O que acontece depois

O RestauraDB prepara o arquivo, válida o destino, cria ou substitui o banco quando necessário, executa a restauração e mostra o andamento na tela. Se houver script posterior, a tela também informa se essa etapa terminou ou falhou.

Como saber se funcionou

A restauração foi concluída quando o RestauraDB mostra a mensagem de sucesso e o andamento chega ao fim sem erro bloqueante.

Depois da conclusão, confira se o banco restaurado é o banco esperado. Se a tela mostrar aviso de verificação ou script, não coloque o banco em uso antes de revisar a mensagem.

Posso cancelar?

Durante a execução, a tela exibe a opção Cancelar. Ao cancelar, o RestauraDB solicita a interrupção da operação em andamento e aguarda o encerramento seguro.

Depois de cancelar, trate o banco de destino como indefinido até conferir a situação. Se for restaurar novamente, use o mesmo cuidado de uma nova substituição.

Caminhos alternativos

• Use F3 para abrir o Seletor Online quando o arquivo ainda precisa ser baixado.
• Use F2 para abrir a Multi-restauração quando houver mais de um banco para restaurar.
• Marque Criar banco em branco somente quando não houver arquivo para restaurar.
• Marque Roda Script quando a tarefa for executar um arquivo .sql.
• Marque Dump quando a tarefa for exportar um banco, não restaurar.

O que pode dar errado

O PostgreSQL não foi encontrado

Confira porta e versão instalada. Se a porta estiver errada, a restauração não encontra os programas ou a instância correta. Veja RDB-PG-001.

A senha do PostgreSQL foi recusada

Digite a senha novamente e confirme se ela pertence a porta informada. Veja RDB-PG-002.

O arquivo não abre

Confirme se o arquivo está completo, se a extensão e suportada e se ele não está aberto em outro programa. Veja RDB-REST-002.

O arquivo compactado pede senha

Digite a senha do arquivo compactado. Se ela estiver incorreta, o RestauraDB não consegue extrair o backup. Veja RDB-REST-003.

O destino está ocupado

Aguarde outra restauração terminar, especialmente na Multi-restauração. Veja RDB-REST-005.

O script falhou

Se a restauração terminou, mas o script posterior falhou, não libere o banco antes de conferir o diagnóstico. Veja RDB-REST-008.

Quando chamar suporte

Chame suporte quando o erro continuar após conferir arquivo, porta, senha e banco de destino, ou quando houver risco de substituir dados importantes.

Informe:

• código exibido pelo RestauraDB;
• tela usada e etapa em que parou;
• tipo do arquivo selecionado;
• host, porta e nome do banco, quando isso for necessário para o atendimento;
• diagnóstico copiado pelo RestauraDB, quando a tela oferecer essa opção.

Não envie senha de banco, senha de arquivo compactado ou conteúdo de script sem orientação do suporte.

Dicas

• Use o botão de logs da própria tela para acompanhar detalhes da execução.

Erros relacionados

Se aparecer um código na tela, consulte o artigo correspondente:

• RDB-PG-001 - PostgreSQL não encontrado
• RDB-PG-002 - Senha do PostgreSQL incorreta
• RDB-PG-003 - Não foi possível conectar ao PostgreSQL
• RDB-REST-001 - Arquivo de backup não encontrado
• RDB-REST-002 - Não foi possível abrir o arquivo de backup
• RDB-REST-003 - Senha do arquivo incorreta
• RDB-REST-004 - A restauração não foi concluída
• RDB-REST-005 - Destino da restauração ocupado
• RDB-REST-006 - Não foi possível validar o destino
• RDB-REST-007 - Falha na verificação do banco restaurado
• RDB-REST-008 - O script pos-restauração falhou
• RDB-REST-009 - Não foi possível ler o arquivo