Performance No Firebird
v21.05a-r
Orienta a configuração e otimização do Firebird para melhorar a performance de consultas, relatórios e backups no Teorema Praxis através de procedimentos iniciais e ferramentas de diagnóstico.
- Título
- Performance no Firebird
- Slug
- performance-no-firebird
- Sistema(s)
- Teorema Praxis
- Categoria
- user_manual
- Tipo
- how-to
- Autor
- Marcelo Ireno Barby
- Setor
- Qualidade
- Modulo
- Performance no Firebird
- Publico
- ""
- Keywords
- Firebird performance firebird.conf databases.conf IBSurgeon gstat gfix page buffers configuração
- Versão Doc
- 01
- Revisão
- Andreia Burko Bley
- Aprovado em
- ""
- Versão Pipeline
- 2.7.0
- Chamado
- ""
- Ultima Revisao
- "2026-06-13"
--- title: Performance no Firebird slug: performance-no-firebird sistema: - Teorema Praxis categoria: user_manual tipo: how-to autor: Marcelo Ireno Barby setor: Qualidade modulo: Performance no Firebird publico: "" keywords: - Firebird - performance - firebird.conf - databases.conf - IBSurgeon - gstat - gfix - page buffers - configuração versao_doc: 01 revisao: Andreia Burko Bley aprovado_em: "" versao_pipeline: 2.7.0 chamado: "" ultima_revisao: "2026-06-13" --- ## Visão Geral Configurações e procedimentos no Firebird que reduzem lentidão em consultas, relatórios, backups e atualizações do sistema. A abordagem cobre o ajuste dos arquivos `firebird.conf` e `databases.conf` com auxílio da ferramenta IBSurgeon, a verificação do Page size e da profundidade de índices via `gstat`, e a correção do Page buffers via `gfix`. > **Nota:** Nem sempre a lentidão é causada pelo banco de dados. Avalie também o servidor e a rede antes de aplicar alterações. ## Procedimentos Iniciais Antes de iniciar qualquer configuração, localize os arquivos `firebird.conf` e `databases.conf` no diretório de instalação do Firebird.  > ⚠️ **Atenção:** Antes de editar qualquer arquivo de configuração, faça uma cópia de segurança do `firebird.conf` e do `databases.conf`. ## Entender os Parâmetros do firebird.conf O arquivo `firebird.conf` controla parâmetros globais do servidor Firebird. Os principais para performance são:  ## Usar o IBSurgeon para Calcular a Configuração O IBSurgeon (HQbird) é uma ferramenta que calcula parâmetros otimizados para o Firebird com base nas características do servidor e do banco de dados. Acesse o site [https://ib-aid.com/](https://ib-aid.com/) e faça um cadastro para utilizá-la.  Após realizar o cadastro, acesse a conta em [https://cc.ib-aid.com/personAccount.html](https://cc.ib-aid.com/personAccount.html). Na seção **Calculate configuration**, clique em **Get config** para iniciar o cálculo.  ## Selecionar Versão e Arquitetura do Firebird Na tela **Calculate configuration**, escolha a versão do Firebird instalada e a arquitetura utilizada.  ## Preencher os Dados do Servidor Com a versão e a arquitetura selecionadas, preencha os campos do formulário com as informações do servidor. Os campos disponíveis são: RAM (Gb), Número total de usuários, Número de núcleos de CPU, Tamanho da página do banco de dados, Tamanho do banco de dados (Gb), Nome do banco de dados principal e Caminho principal do banco de dados.  ## Identificar o Número de CPUs Lógicos Para preencher corretamente o campo **Número de núcleos de CPU**, verifique a quantidade de processadores lógicos no Gerenciador de Tarefas do Windows (aba Desempenho > CPU).  ## Identificar o Page Size do Banco de Dados Execute o comando `gstat` para obter o Page size atual do banco de dados: ``` gstat c:\teorema\windados\22.07a\base30.fdb ``` O valor de **Page size** exibido no cabeçalho deve ser informado no campo correspondente do IBSurgeon.  ## Identificar a Profundidade dos Índices Execute o comando abaixo para levantar a profundidade dos índices do banco e redirecionar o resultado para um arquivo: ``` gstat -i caminhodobancocompleto -user SYSDBA | grep "Index\|depth" > c:\temp\teste.txt ```  ## Atualizar o Formulário com os Dados Obtidos De volta ao IBSurgeon, preencha os campos com os valores coletados (Page size, número de núcleos lógicos, tamanho do banco, etc.) e clique em **Criar** para gerar a configuração recomendada.  ## Obter os Arquivos de Configuração Calculados Após clicar em **Criar**, o IBSurgeon exibe os conteúdos sugeridos para `firebird.conf` e `databases.conf`. Copie cada bloco para os respectivos arquivos no diretório da versão do Firebird instalada.  ## Fazer Backup dos Arquivos Antes de Alterar Antes de substituir os arquivos de configuração, crie cópias de segurança do `firebird.conf` e do `databases.conf` no diretório de instalação do Firebird.  ## Atualizar o firebird.conf Copie o conteúdo gerado pelo IBSurgeon e cole no arquivo `firebird.conf` localizado no diretório da versão do Firebird escolhida.  ## Atualizar o databases.conf Copie o conteúdo gerado pelo IBSurgeon e cole no arquivo `databases.conf` localizado no diretório da versão do Firebird escolhida.  ## Verificar o firebird.conf Padrão Antes da Alteração O arquivo `firebird.conf` padrão (antes de qualquer alteração) contém apenas comentários explicativos e entradas desativadas com `#`. Todas as entradas precisam ter o `#` removido para serem ativadas.  > ⚠️ **Atenção:** Quando houver mais de uma instância do Firebird instalada, verifique a porta de acesso utilizada por cada instância. O parâmetro `RemoteServicePort` no `firebird.conf` define a porta TCP de cada instância.  ## Conferir o firebird.conf Após a Atualização Após colar o conteúdo gerado pelo IBSurgeon, o `firebird.conf` deve apresentar os parâmetros ativos (sem `#`).  ## Verificar o databases.conf Padrão Antes da Alteração O `databases.conf` padrão contém entradas de exemplo comentadas e o bloco obrigatório do banco de segurança (`security.db`). Mantenha o bloco `security.db` intacto ao editar o arquivo.  ## Conferir o databases.conf Após a Atualização Após colar o conteúdo gerado pelo IBSurgeon, o `databases.conf` deve conter o bloco atualizado do `security.db` e o bloco do banco de dados principal com os parâmetros de cache.  ## Verificar e Corrigir o Page Buffers do Banco O Page buffers definido diretamente no banco de dados substitui o valor do `firebird.conf`. Se o valor for diferente de `0`, o banco ignora o parâmetro global e usa o valor local — o que pode limitar a performance. Execute `gstat` para verificar o valor atual: ``` gstat c:\teorema\windados\21.05a\base30.fdb ```  Se o Page buffers for diferente de `0`, corrija com o comando `gfix`: ``` gfix -b 0 c:\teorema\windados\22.07a\base30.fdb -user SYSDBA ```  > **Nota:** O valor `0` significa que o banco usará o `DefaultDbCachePages` definido no `firebird.conf` ou no `databases.conf`, o que é o comportamento desejado após a configuração via IBSurgeon. ## Reiniciar o Serviço do Firebird Após todas as alterações, pare e reinicie o serviço do Firebird para que as configurações sejam aplicadas. Acesse o Gerenciador de Serviços do Windows, localize a instância correspondente e utilize as opções **Parar** e **Reiniciar**.  ## Links Úteis - <https://portal.revendadesoftware.com.br/faqs/como-otimizar-a-performance-do-firebird> - <https://cc.ib-aid.com/personAccount.html> - <https://www.firebase.com.br/index.php> ## Informações do documento > Autor: Marcelo Ireno Barby > Setor: Qualidade > Módulo: Performance no Firebird > Chamado: > Versão do Sistema: 21.05a > Versão do documento: 01 > Revisão: Andreia Burko Bley > Aprovado em: --- > 📎 **Arquivos originais:** [Manual Performance no Firebird.docx](https://drive.google.com/uc?export=download&id=19tGfTHrTcyiZmB_6IBH7fcf1OY2A1D-W) · [Manual Performance no Firebird.pdf](https://drive.google.com/uc?export=download&id=1MAgJmYZklJjlsPEBwzI-9b0M48mZ2wpe) · [Manual Performance no Firebirdmod.pdf](https://drive.google.com/uc?export=download&id=1IY5ZxMQkFLtxBUQBRRVfLSbGd6VMXDwHf)
Tags IA:
2023
anteriores
docx
firebird
junho
manuais
performance
performance-no-firebird
Prioridade: 7