Performance No Firebird

---
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.

![Explorador de arquivos mostrando o diretório C:\Arquivos de Programas\Firebird\Firebird_3_0 com os arquivos databases (Arquivo CONF, 1 KB), firebird (Arquivo CONF, 35 KB) e firebird.conf.default destacados entre as pastas e executáveis da instalação](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-01.png)

> ⚠️ **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:

![Trecho do firebird.conf exibindo comentários explicativos sobre MaxUserTraceLogSize, DefaultDbCachePages, DatabasesInMemory e parâmetros de cache e conexão por banco de dados](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-02.png)

## 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.

![Página inicial do site ib-aid.com exibindo o produto HQbird — Advanced FirebirdSQL for Big Databases — com botão Download](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-03.png)

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.

![Painel da conta no IBSurgeon (cc.ib-aid.com) com seções Traces, Servers e Calculate configuration; seta indicando o botão Get config na barra lateral esquerda](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-04.png)

## Selecionar Versão e Arquitetura do Firebird

Na tela **Calculate configuration**, escolha a versão do Firebird instalada e a arquitetura utilizada.

![Tela Calculate configuration do IBSurgeon com opções de versão: Firebird 4 (vanilla), Firebird 4 HQbird, Firebird 3 (vanilla) — destacado —, Firebird 3 HQbird, Firebird 2.5 (vanilla), Firebird 2.5 HQbird; e opções de arquitetura: SuperServer, Classic, SuperClassic; botão Create ao final](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-05.png)

## 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.

![Formulário Calculate configuration do IBSurgeon com arquitetura SuperServer selecionada e campos preenchidos: RAM 16 Gb, Número total de usuários 100, Número de núcleos de CPU 8, Tamanho da página 4096, Tamanho do banco 100 Gb, Nome do banco testdb, Caminho c:\temp\mydb1.fdb](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-06.png)

## 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).

![Gerenciador de Tarefas do Windows na aba Desempenho exibindo CPU Intel Core i7-11800H a 2,30 GHz; detalhe: Sockets 1, Núcleos 8, Processadores lógicos 16](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-07.png)

## 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.

![Terminal exibindo saída do gstat para C:\TEOREMA\WINDADOS\22.07A\BASE30.FDB com campo Page size igual a 4096 destacado em vermelho; demais campos: Flags 0, Generation 2930, ODS version 12.0, Page buffers 10000](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-08.png)

## 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
```

![Saída do gstat -i exibindo lista de índices com seus respectivos depth (profundidade): FK_ACORDO_DT_MS depth 1, PK_ACORDO_DT depth 1, FK_ACORDO_MS_CLIFOR depth 1, FK_ACORDO_MS_EMPRESA depth 1, PK_ACORDO_MS depth 1, entre outros — todos com depth 1](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-09.png)

## 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.

![Formulário Calculate configuration do IBSurgeon com Firebird 3 (vanilla) e arquitetura SuperServer selecionados; campos: RAM 16 Gb, Número total de usuários 30, Número de núcleos de CPU 16, Tamanho da página 4096, Tamanho do banco 15 Gb, Nome do banco base30, Caminho c:\teorema\windados\2](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-10.png)

## 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.

![Tela de resultado do IBSurgeon exibindo dois blocos de configuração: firebird.conf com parâmetros ServerMode=Super, DefaultDbCachePages=50K, FileSystemCacheThreshold=999M, TempCacheLimit=2048M, LockHashSlots=49999, TempBlockSize=2M, MaxUnflushedWrites=-1, MaxUnflushedWriteTime=-1, WireCrypt=Enabled, RemoteServicePort=3050, AuthServer=Srp Legacy_Auth, UserManager=Srp Legacy_UserManager; e databases.conf com blocos security.db e base30 com DefaultDBCachePages=1048576 e LockMemSize=20M](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-11.png)

## 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.

![Explorador de arquivos em C:\Arquivos de Programas\Firebird\Firebird_3_0 mostrando o arquivo firebird - Copia (Arquivo CONF, 35 KB) ao lado do firebird original, confirmando que o backup foi criado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-12.png)

## 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.

![Resultado do IBSurgeon para firebird.conf com os parâmetros: ServerMode=Super, DefaultDbCachePages=50K, FileSystemCacheThreshold=999M, TempCacheLimit=2048M, LockHashSlots=49999, TempBlockSize=2M, MaxUnflushedWrites=-1, MaxUnflushedWriteTime=-1, WireCrypt=Enabled, RemoteServicePort=3050, AuthServer=Srp Legacy_Auth, UserManager=Srp Legacy_UserManager](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-13.png)

## 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.

![Resultado do IBSurgeon para databases.conf com os blocos: security.db com RemoteAccess=false e DefaultDbCachePages=250; e base30 apontando para c:\teorema\windados\22.07a\base30.fdb com DefaultDBCachePages=1048576 e LockMemSize=20M](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-14.png)

## 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.

![Editor de texto exibindo o início do firebird.conf padrão (Firebird version 3.0 configuration file) com seções Comments, Entries, Integer e Boolean descritas em inglês; todas as entradas de configuração estão comentadas com #](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-15.png)

> ⚠️ **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.

![Trecho do firebird.conf com a seção TCP Protocol Settings mostrando RemoteServicePort = 3030 ativo (sem #) e RemoteServiceName comentado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-16.png)

## 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 `#`).

![firebird.conf após atualização com parâmetros ativos: ServerMode=Super, DefaultDbCachePages=50K, FileSystemCacheThreshold=999M, TempCacheLimit=2048M, LockHashSlots=49999, TempBlockSize=2M, MaxUnflushedWrites=-1, MaxUnflushedWriteTime=-1, WireCrypt=Enabled, RemoteServicePort=3030, AuthServer=Srp Legacy_Auth, UserManager=Srp Legacy_UserManager](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-17.png)

## 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.

![databases.conf padrão exibindo comentários sobre configuração por banco, entrada de exemplo employee.fdb, bloco security.db com RemoteAccess=false e DefaultDbCachePages=50, e seção Live Databases vazia](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-18.png)

## 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.

![databases.conf após atualização com bloco security.db destacado em vermelho (RemoteAccess=false, DefaultDbCachePages=250) e bloco base30 destacado em vermelho apontando para c:\teorema\windados\22.07a\base30.fdb com DefaultDBCachePages=1048576 e LockMemSize=20M](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-19.png)

## 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
```

![Terminal cmd exibindo saída do gstat para C:\TEOREMA\WINDADOS\21.05A\BASE30.FDB com Page buffers igual a 10000 destacado em vermelho; demais campos: Page size 4096, ODS version 12.0, Oldest transaction 3711, Next attachment ID 97](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-20.png)

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
```

![Terminal cmd exibindo gstat para C:\TEOREMA\WINDADOS\22.07A\BASE30.FDB com Page buffers igual a 0 destacado em vermelho — banco configurado para usar o valor global do firebird.conf; mensagem "Unable to perform operation. You must be either SYSDBA or owner of the database" ao final](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-21.png)

> **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**.

![Gerenciador de Serviços do Windows com Firebird Server — Firebird30 selecionado e com status Em Execução; lista mostra também Firebird Server — DefaultInstance, Firebird25 e Firebird40 em execução; painel lateral exibe links Parar o serviço e Reiniciar o serviço](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/performance-no-firebird/performance-no-firebird-22.png)

## 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)