SGH –

BACKUP /
RESTORE
DO BANCO
DE DADOS
FIREBIRD

SETOR DE SUPORTE E MANUTENÇÃO DE APLICAÇÕES – SMA

Sander Rosse Santana – Gerente do SMA
Creuza de Jesus Silva – Coordenadora do SMA
Heloísa Narciso Sipriano de Jesus – Coordenadora do SMA
Nelma Monfardini – Analista de Documentação
quarta-feira, 1 de dezembro de 2021
SUMÁRIO

1. Introdução ........................................................................................................... 3
2. Recomendações ................................................................................................. 3
3. Dicas de Segurança ............................................................................................ 3
4. Realizando o backup .......................................................................................... 4
5. Passo a passo dos Backups.............................................................................. 4
5.1. Backup no Windows .................................................................................................... 4
5.2. Backup no Linux .......................................................................................................... 6
5.3. Backup Automático ..................................................................................................... 7
5.4. Para realizar o backup no Ibexpert .............................................................................. 7
6. Restauração e Validação de banco de dados SGH........................................ 10
6.1. Restore no Windows ................................................................................................. 10
6.2. Restore no Linux ................................................................................................... 12
7. Referências ....................................................................................................... 14

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 2

 1. Introdução

O backup do banco de dados Firebird possui uma ferramenta de linha de comando

para ser executada via prompt de comando no Windows ou via terminal no Linux,
sendo específica para realização de backups e para restaurar cópias de segurança.

O objetivo deste documento é orientar o usuário do sistema na realização dos backups

de bancos de dados Firebird.

2. Recomendações

1. Faça o backup do banco de dados com a versão do gbak fornecida com o

servidor de banco de dados em utilização no servidor de produção.
2. Verifique o tempo para se criar um backup e em quanto tempo é realizado o
backup. Estimar esses tempos é importante antes de realizar um agendamento
de backup automático.
3. O backup consome recursos do servidor, por isso, se o seu HD não tem alta
performance de escrita, não realize o backup em horário de maior utilização do
sistema.

3. Dicas de Segurança

1. Mantenha os backups em um local seguro. Armazenar backups em um local

com acesso restrito ajuda a reduzir as chances de seus arquivos de backup
serem perdidos.
2. Certifique-se de que apenas usuários autorizados tenham acesso a unidades
onde os backups são mantidos.
3. Não armazene cópias de backup e bases de dados em um mesmo dispositivo.
4. Sempre que possível realize testes de integridade dos backups, realizando
restore do backup para validação do backup.
5. Nunca execute o backup do banco de dados via cópia (Ctrl+C/Ctrl+V), e via
compactação com banco em produção. Caso seja necessário realizar uma

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 3

 cópia do banco, todos os usuários devem sair do sistema e parar o serviço do
Firebird.
6. Verifique, periodicamente, o espaço disponível em disco. Se não há espaço
suficiente no disco, o processo de backup consumirá todo o espaço disponível
e irá apresentar erros.

Importante: se a partição usada para o backup for a mesma que armazena a base de dados e não existir
espaço disponível, ocorrerá a interrupção do serviço. Caso seja a mesma do sistema operacional, poderá
resultar em uma falha do sistema, podendo, até mesmo, causar uma corrupção da base de dados.

4. Realizando o backup
As sintaxes básicas do comando para realização do backup do banco de dados é:
Gbak -b -v -g -l -user sysdba -password senha_user_sysdba arquivo_do_banco
arquivo_backup

Legenda:

• B: backup do banco de dados para o arquivo.

• V: Visualizar cada ação executada.
• G: Não realiza coleta de lixo.
• L: ignora transações no limbo.
• usuário: nome de login do usuário (geralmente SYSDBA).
• senha: senha do usuário SYSDBA.
• arquivo_banco: arquivo de banco de dados (geralmente com extensão.
Codigo_da_instituição).
• arquivo_backup: arquivo de backup (geralmente com extensão. gbk).

5. Passo a passo dos Backups

5.1. Backup no Windows

1. Para realizar o backup no Windows, acesse o prompt de comando.

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 4

 2. Navegue até a pasta C:\Program Files\Firebird\Firebird_3_0.

3. Utilize o executável gbak.exe para acionar o backup via comando, utilizando

a linha de comando
gbak -b -v -g -l -user sysdba - password senha_usuario_sysdba
caminho_do_banco_de_dados caminho_do_backup.

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 5

 5.2. Backup no Linux

1. Para realizar o backup no Linux, acesse o terminal.

2. Navegue até a pasta bin do Firebird em /opt/firebird/bin#.

3. Utilize o arquivo gbak para acionar o backup via comando, utilizando a

linha de comando ./gbak -b -v -g -l -user sysdba -password
senha_user_sysdba /work/banco/sghdados.001
/work/backup/001backup.gbk

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 6

 5.3. Backup Automático

O backup automático também pode ser implantado utilizando agendador de tarefas

no Windows e Crontab no Linux. Crie o seu script / arquivo .bat para realização do
backup automático, seguindo as orientações e comandos indicados neste documento.

5.4. Backup no Ibexpert

Para que o backup possa ser feito, é preciso realizar o registro do banco no Ibexpert.

1. Abra o Ibexpet e clique em Database > Register Database. Faça o registro

conforme a tela abaixo, conforme o nome do deu banco de dados.

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 7

 2. Acesse a opção services > Database Backup.

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 8

Descrição de campos:

• Select database: refere-se ao banco de dados que irá realizar o backup.

Caso tenha mais de um registro de banco de dados realizado, serão exiidos.
• Exemplo: sghdados.001, sghimagens.gdb e sghlog.gdb. Selecione o banco
para o qual será realizado o backup.
• Files name: refere-se ao nome dado ao arquivo de backup e o caminho que
será salvo o backup.

Nota: salve o arquivo dentro do servidor. Não realize o backup pela rede, caso o seu ibexpert esteja
resistrado em um terminal de trabalho

• Opções: marque apenas ignore transaction in limbo e garbage collection.

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 9

 6. Restauração e Validação de banco de dados SGH

O processo de restauração tem como objetivo a validação do banco de dados e a

verificação de integridade do banco.
Motivos pelos quais deve-se validar os bancos de dados.

• Backup de banco de dados corrompido ou com erros.

• Para monitorar estruturas de dados corrompidas ou espaço mal alocado.
• Sempre que houver suspeitas de corrupção de dados.

6.1. Restore no Windows

Para realizar o restore do banco de dados gerando um arquivo de Log para

conferência:

1. Acesse o prompt de comando.

2. Navegue até a pasta C:\Program Files\Firebird\Firebird_3_0.

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 10

 3. Utilize o executável gbak.exe para acionar o backup via comando, utilizando a
linha de comando gbak -c -v -p 8192 -user sysdba -password
senha_usuario_sysdba caminho_do_backup caminho_do_banco_de_dados >
caminho do log do restore.

4. Após a realização e finalização do restore, confira o resultado do log gerado.

O log deve finalizar conforme linhas abaixo:

gbak:fixing views dbkey length

gbak:updating ownership of packages, procedures and tables
gbak:adding missing privileges
gbak:adjusting system generators
gbak:finishing, closing, and going home
gbak:adjusting the ONLINE and FORCED WRITES flags

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 11

 6.2. Restore no Linux

1. Acesse o terminal.

2. Navegue até a pasta bin do Firebird em /opt/firebird/bin#.

3. Utilize o arquivo gbak para acionar o restore via comando, utilizando a linha
de comando ./gbak -c -v -p 8192 -user sysdba -password senha_user_sysdba
/work/backup/001backup.gbk /work/banco/sghdados.001 >
/work/banco/logbkp001.txt

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 12

 4. Após a realização e finalização do restore, confira o resultado do log gerado.
O log deve finalizar conforme linhas abaixo:

gbak:fixing views dbkey length

gbak:updating ownership of packages, procedures and tables
gbak:adding missing privileges
gbak:adjusting system generators
gbak:finishing, closing, and going home
gbak:adjusting the ONLINE and FORCED WRITES flags

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 13

7. Referências
SPDATA. Sistema de Gestão Hospitalar. 2021. Disponível em: SPDATA - Soluções para
Gestão Hospitalar. Acesso em: 11 mar. 2021.

Manual SGH – Backup de Banco de Dados Firebird - Versão 1.0 14