¶ Como executar o Backup/Restore do banco de dados Questor?
O Backup/Restore é um procedimento de manutenção do banco de dados que corrige problemas na base de dados e melhora o desempenho do sistema. Recomenda-se sua execução a cada 30 dias para garantir a integridade dos dados.
¶ Verificando a data da última manutenção
Antes de iniciar o procedimento, é possível verificar quando foi realizada a última manutenção do banco de dados. Acesse qualquer módulo do sistema e navegue até Utilitários > Banco de dados > Informações de Conexão.
Quando o banco de dados possui uma base de log separada, a tela exibida apresenta as informações da base de dados na parte superior e os dados da base de log na parte inferior.
⚠️ Atenção!
A execução do Backup/Restore é recomendada a cada 30 dias para o banco de dados principal. Para a base de log, o procedimento raramente é necessário.
¶ Pré-requisitos
- Todos os usuários devem estar desconectados do sistema antes de iniciar o procedimento.
- Ter acesso ao diretório de instalação do Questor para localizar o aplicativo RecuperaFDB.exe.
- Conhecer o caminho do banco de dados e a senha do Firebird.
¶ 1º Passo — Localizar o arquivo do banco de dados
O arquivo do banco de dados geralmente está localizado em C:\nQUestor\Base. Acesse esse diretório pelo Explorador de Arquivos.
¶ 2º Passo — Abrir o arquivo com o aplicativo correto
Clique com o botão direito sobre o arquivo do banco de dados, selecione Abrir com e em seguida Escolher Outro Aplicativo.
Na janela exibida, selecione a opção Procurar outro aplicativo neste PC.
¶ 3º Passo — Executar o RecuperaFDB.exe
Localize o aplicativo RecuperaFDB.exe na pasta de instalação do Questor e clique em Abrir.
¶ 4º Passo — Iniciar a reconstrução do banco
O sistema exibirá uma tela com os campos preenchidos automaticamente, incluindo o caminho do banco no primeiro campo. Caso a senha do Firebird e o caminho do Firebird sejam os padrões, clique em Reconstruir ou Restaurar para iniciar o processo.
⚠️ Atenção!
O procedimento só pode ser realizado com todos os usuários desconectados do sistema.
¶ 5º Passo — Aguardar a conclusão do processo
Após iniciar, o sistema exibirá a tela de progresso da execução.
⚠️ Atenção!
Durante a execução, o aplicativo pode apresentar o status Não Respondendo. Isso é esperado — o processo está sendo executado normalmente. Aguarde a conclusão sem interrompê-lo.
Ao concluir, o sistema exibirá uma mensagem de finalização.
¶ 6º Passo — Verificar os arquivos gerados
Após a conclusão, a pasta do banco de dados conterá os seguintes arquivos.
Os arquivos gerados são os seguintes:
- QuestorVELHO.fdb: Cópia do banco de dados original, gerada antes da execução do procedimento.
- Questor.fbk: Backup do banco de dados gerado antes do procedimento.
- QUESTOR.FDB: Novo arquivo do banco de dados criado após o Backup/Restore.
¶ 7º Passo — Confirmar o sucesso do procedimento
Para validar que o processo foi concluído com êxito, abra os dois arquivos de log gerados na pasta do banco: Questor.fbk.log e Questor.fdb.log.
O final do arquivo Questor.fbk.log deve apresentar o seguinte conteúdo quando o procedimento for bem-sucedido.
O final do arquivo Questor.fdb.log deve apresentar o seguinte conteúdo quando o procedimento for bem-sucedido.
Após confirmar o sucesso, acesse novamente o sistema e verifique as informações de conexão em Utilitários > Banco de dados > Informações de Conexão para validar a data da última manutenção.
¶ Backup/Restore em sistemas operacionais Linux
Em ambientes Linux, o procedimento é realizado via linha de comando utilizando o utilitário gbak do Firebird. Os comandos devem ser executados com permissão de superusuário.
Gerar o backup:
sudo gbak -b /CAMINHO-DO-ARQUIVO/banco.fdb /CAMINHO-DO-BACKUP/banco.fbk -user USUARIO_DO_BANCO -pas SENHA_DO_BANCO -v > LogBKP.txt
Restaurar o backup:
sudo gbak -r /path/NomeDoArquivo.fbk /NomeDoArquivoASerCriadonoFireBird.fdb -user USUARIO_DO_BANCO -pas SENHA_DO_BANCO -v > LogRestore.txt
Os parâmetros utilizados nos comandos têm as seguintes funções:
- USUARIO_DO_BANCO: Nome do usuário do banco de dados. O padrão é
sysdba. - SENHA_DO_BANCO: Senha do banco de dados Firebird.
- -b: Gera o arquivo de backup. Obrigatório para a operação de backup.
- -r: Restaura o arquivo de backup (.fbk) em um novo banco de dados (.fdb).
- -v: Exibe em tela o progresso do processo em execução.
- >: Exporta o retorno do processo para o arquivo de saída informado.
⚠️ Atenção!
Após gerar o backup, renomeie o arquivo do banco de dados original antes de restaurar o novo arquivo com o nome correto. Isso evita que o banco de dados atual seja sobrescrito.
¶ Erros comuns
Esta seção descreve os erros que podem ocorrer durante a execução do procedimento e suas respectivas soluções.
- Motivo: Usuário ou senha do Firebird informados estão incorretos.
- Solução: Corrija o usuário e a senha na janela de execução do procedimento e tente novamente.
- Motivo: O processo foi interrompido porque havia usuários conectados ao banco de dados no momento da execução.
- Solução: Solicite que todos os usuários saiam do sistema e verifique se outros serviços estão utilizando o banco de dados, como nRob.exe, nWeb.exe e nJobs.exe.