1. Como Realizar o Restore do Banco

O procedimento de restore do banco de dados deve ser iniciado pela validação do tipo de operação:

2. Procedimento de Restore em Base Limpa (Instalação Nova)

Este procedimento é utilizado quando o banco de dados de destino é novo ou vazio.

2.1. Download do Arquivo de Backup

Baixar o arquivo de backup correspondente ao ERP utilizado.

3. Procedimento de Restore em Base Existente:

Obs: Processo utilizado tanto para migração de ambiente como para atualização de base.

Importante!

Para realizar o procedimento recomendamos:

• Parar a aplicação (WildFly, Sincronização).
• Desabilitar as integrações no Agendador de Tarefas/Crontab.
• Aguardar a finalização das integrações em andamento.
• Após interromper a aplicação e finalizadas as integrações, reiniciar o banco de dados para evitar que processos pendentes impeçam a execução do restore.

3.1. Para essa forma o primeiro passo é gerar um backup do banco, Em caso de dúvidas sobre como gerar o backup utilizar a documentação de backup.

4. Processo de restore:

4.1. Acessando o Diretório bin do PostgreSQL

Para realizar o processo de restore é necessário acessar a pasta bin da instalação do PostgreSQL

4.1.1. Para Windows

O diretório bin está localizado na pasta de instalação do PostgreSQL.

• Caminho Padrão: ?:\ws\database\bin (Onde ? representa o disco de instalação.)

4.1.2. Para Linux

O diretório bin está localizado no caminho de instalação padrão do PostgreSQL.

• Caminho Padrão: /usr/pgsql/<versão>/bin/ (Onde <versão> deve ser substituído pela versão do PostgreSQL instalada, ex: 9.6, 12, etc.)

4.2. Executando o Comando de Restore

Neste ponto, você precisará detalhar o comando a ser executado para realizar o restore. O comando geralmente envolve o utilitário pg_restore e pode ter variações leves, mas o padrão é aplicável a ambos os S.O.s.

• Abrir o Terminal/Prompt de Comando: Abra o Prompt de Comando (Windows) ou Terminal (Linux) e navegue até o diretório bin (conforme item 4.1).

# Exemplo de comando genérico para pg_restore
pg_restore -l <endereco_do_banco> -p <porta> -U <usuário> --verbose -d <nome_do_banco_novo> <caminho_completo_do_arquivo_backup>

Detalhando os parâmetros:

• -l <endereco_do_banco>:Endereço do servidor onde está o banco, caso esteja no servidor que está executando alterar <endereco_do_banco> por localhost.
• -p <porta>: Porta que o PostgreSQL está configurado, a instalação padrão do PostgreSQL utiliza a porta 5432, porém a mesma pode ser alterada na instalação.
• -U <usuário>: Usuário do banco de dados (geralmente postgres).
• --verbose: Ativa o modo detalhado, fazendo com que o pg_restore exiba mensagens de progresso e informações mais detalhadas sobre os objetos do banco de dados à medida que são restaurados.
• -d <nome_do_banco_novo>: O nome que será dado à nova base de dados.
• <caminho_completo_do_arquivo_backup>: O caminho para o arquivo .backup baixado na etapa 2.1.

Obs: Durante a execução pode ser necessário informar a extensão do pg_restore, para Windows fica pg_restore.bat e para Linux pg_restore.sh.

Caso desejar realizar o restore dropando o banco anterior utilizar o seguinte comando:

pg_restore -l <endereco_do_banco> -p <porta> -U <usuário> -c --verbose -d <nome_do_banco_novo> <caminho_completo_do_arquivo_backup>

O parâmetro -c irá dropar todos os objetos do banco de dados antes de realizar o restore.