dmosk / pgtune

Ottimizzazione della configurazione PostgreSQL

Genera un estratto di postgresql.conf per il tuo server: versione, SO, carico, RAM, CPU, connessioni e storage. Ogni valore è spiegato e tutti i calcoli avvengono nel browser.

Hardware e carico

Perché usare pgtune

  • Configurazione per il tuo hardware. Inserisci RAM, CPU, storage e profilo di carico per ottenere shared_buffers, work_mem, WAL e parallelismo.
  • PostgreSQL 14–19. I parametri seguono la versione scelta, ad esempio io_method dalla 18, wal_compression e opzioni di vacuum.
  • Spiegazioni e avvisi. Ogni parametro ha un motivo breve; lo strumento segnala rischio OOM, huge pages, LZ4, io_uring e impostazioni che richiedono riavvio.
  • Cinque profili e tipi di storage. Web, OLTP, data warehouse, desktop e carico misto; SSD, HDD, SAN e NVMe.
  • Solo nel browser. Nessun server né API: i parametri non lasciano il dispositivo. Gratis, in 23 lingue, con link condivisibile.

Come ottimizzare PostgreSQL

  1. Scegli versione di PostgreSQL, sistema operativo e profilo di carico.
  2. Inserisci la RAM totale e l’unità e, se li conosci, core CPU e connessioni massime.
  3. Seleziona il tipo di storage e se i dati sono più piccoli, simili o più grandi della RAM.
  4. Premi «Genera», leggi spiegazioni e avvisi e copia l’estratto in postgresql.conf.

Sulle impostazioni generate

Il risultato è un punto di partenza basato su euristiche note per memoria, WAL, planner e parallelismo. Non sostituisce test di carico e monitoraggio sui tuoi dati.

Consigli:

  • Le impostazioni che richiedono riavvio sono contrassegnate da un badge dedicato.
  • work_mem vale per operazione, non per connessione: una query complessa può usarlo più volte.
  • Con molti client usa un pooler come PgBouncer invece di alzare max_connections.
  • Su Linux, con shared_buffers da 2 GB in su, abilita le huge pages.
  • Dopo la modifica controlla EXPLAIN (ANALYZE, BUFFERS) e pg_stat_statements, cambia i parametri per gruppi e conserva la configurazione precedente.

A cosa serve pgtune

  • ottenere una configurazione iniziale sensata per un nuovo server PostgreSQL;
  • ricalcolare dopo aver aggiunto RAM o CPU o aggiornato la versione maggiore;
  • confrontare i profili (web, OLTP, analitica) sullo stesso hardware;
  • motivare la scelta dei parametri in una review o in un runbook.

Domande frequenti

pgtune invia i miei parametri a un server?

No. Tutti i calcoli avvengono nel browser e non esiste alcuna API.

Quali versioni di PostgreSQL sono supportate?

Dalla 14 alla 19. L’insieme dei parametri e i loro valori dipendono dalla versione scelta.

Posso incollare il risultato direttamente in produzione?

Consideralo un punto di partenza. Leggi gli avvisi, applicalo a un’istanza di test e osserva le metriche sotto carico reale.

Perché max_connections è basso anche per un database grande?

Ogni connessione consuma memoria e work_mem viene diviso tra esse. Un pooler come PgBouncer è spesso meglio di migliaia di connessioni dirette.

E se non conosco CPU o connessioni?

Lascia i campi vuoti: i valori sono scelti in base a profilo e RAM e il risultato mostra le connessioni assunte.