dmosk / pgtune

Ajuste da configuração do PostgreSQL

Gere um trecho de postgresql.conf para o seu servidor: versão, SO, carga, RAM, CPU, ligações e armazenamento. Cada valor vem explicado e todos os cálculos correm no navegador.

Hardware e carga

Porquê usar o pgtune

  • Configuração para o seu hardware. Indique RAM, CPU, armazenamento e perfil de carga e obtenha shared_buffers, work_mem, WAL e paralelismo.
  • PostgreSQL 14–19. Os parâmetros seguem a versão escolhida, por exemplo io_method no 18+, wal_compression e opções de vacuum.
  • Explicações e avisos. Cada parâmetro tem um motivo curto; são assinalados risco de OOM, huge pages, LZ4, io_uring e definições que exigem reinício.
  • Cinco perfis e tipos de disco. Web, OLTP, data warehouse, desktop e carga mista; SSD, HDD, SAN e NVMe.
  • Só no navegador. Sem servidor nem API: os parâmetros não saem do dispositivo. Grátis, em 23 idiomas e com link para partilhar.

Como ajustar o PostgreSQL

  1. Escolha a versão do PostgreSQL, o sistema operativo e o perfil de carga.
  2. Indique a RAM total e a unidade e, se souber, os núcleos de CPU e o máximo de ligações.
  3. Selecione o tipo de armazenamento e se os dados são menores, semelhantes ou maiores que a RAM.
  4. Clique em «Gerar», leia as explicações e avisos e copie o trecho para postgresql.conf.

Sobre as definições geradas

O resultado é um ponto de partida baseado em heurísticas conhecidas de memória, WAL, planeador e paralelismo. Não substitui testes de carga nem monitorização com os seus dados.

Dicas:

  • As definições que exigem reinício são marcadas com um selo próprio.
  • work_mem aplica-se por operação, não por ligação: uma consulta complexa pode usá-lo várias vezes.
  • Com muitos clientes, use um pooler como o PgBouncer em vez de aumentar max_connections.
  • No Linux, com shared_buffers de 2 GB ou mais, ative as huge pages.
  • Depois da alteração, confira EXPLAIN (ANALYZE, BUFFERS) e pg_stat_statements, altere parâmetros por grupos e guarde a configuração anterior.

Para que serve

  • obter uma configuração inicial sensata para um novo servidor PostgreSQL;
  • recalcular após adicionar RAM ou CPU ou atualizar a versão principal;
  • comparar perfis (web, OLTP, análise) no mesmo hardware;
  • justificar a escolha de parâmetros numa revisão ou runbook.

Perguntas frequentes

O pgtune envia os meus parâmetros para um servidor?

Não. Todos os cálculos correm no navegador e não existe API.

Que versões do PostgreSQL são suportadas?

Da 14 à 19. O conjunto de parâmetros e os valores dependem da versão escolhida.

Posso colocar o resultado diretamente em produção?

Trate-o como ponto de partida. Reveja os avisos, aplique numa instância de teste e observe as métricas com carga real.

Porque é que max_connections é baixo mesmo numa base grande?

Cada ligação consome memória e work_mem é dividido entre elas. Um pooler como o PgBouncer costuma ser melhor do que milhares de ligações diretas.

E se não souber a CPU ou as ligações?

Deixe os campos vazios: os valores são escolhidos pelo perfil e pela RAM e o resultado mostra as ligações assumidas.