dmosk / pgtune

Réglage de la configuration PostgreSQL

Générez un extrait de postgresql.conf pour votre serveur : version, OS, charge, RAM, CPU, connexions et stockage. Chaque valeur est expliquée et tous les calculs se font dans le navigateur.

Matériel et charge

Pourquoi utiliser pgtune

  • Une configuration pour votre matériel. Indiquez RAM, CPU, stockage et profil de charge pour obtenir shared_buffers, work_mem, WAL et parallélisme.
  • PostgreSQL 14–19. Les paramètres suivent la version choisie, par exemple io_method en 18+, wal_compression et options de vacuum.
  • Explications et avertissements. Chaque paramètre a une raison courte ; l’outil signale risque d’OOM, huge pages, LZ4, io_uring et réglages nécessitant un redémarrage.
  • Cinq profils et types de stockage. Web, OLTP, entrepôt de données, poste de travail et charge mixte ; SSD, HDD, SAN et NVMe.
  • Uniquement dans le navigateur. Ni serveur ni API : les paramètres ne quittent pas l’appareil. Gratuit, en 23 langues, avec lien partageable.

Comment régler PostgreSQL

  1. Choisissez la version de PostgreSQL, le système d’exploitation et le profil de charge.
  2. Saisissez la RAM totale et son unité, ainsi que les cœurs CPU et le nombre max de connexions si vous les connaissez.
  3. Sélectionnez le type de stockage et indiquez si les données sont plus petites, proches ou plus grandes que la RAM.
  4. Cliquez sur « Générer », lisez explications et avertissements, puis copiez l’extrait dans postgresql.conf.

À propos des réglages générés

Le résultat est un point de départ fondé sur des heuristiques connues pour la mémoire, le WAL, le planificateur et le parallélisme. Il ne remplace ni les tests de charge ni la supervision sur vos données.

Conseils :

  • Les réglages qui exigent un redémarrage sont signalés par un badge distinct.
  • work_mem s’applique par opération, pas par connexion : une requête complexe peut l’utiliser plusieurs fois.
  • Avec beaucoup de clients, utilisez un pooler comme PgBouncer plutôt que d’augmenter max_connections.
  • Sous Linux, avec shared_buffers de 2 Go ou plus, activez les huge pages.
  • Après le changement, vérifiez avec EXPLAIN (ANALYZE, BUFFERS) et pg_stat_statements, modifiez les paramètres par groupes et gardez l’ancienne configuration.

À quoi sert pgtune

  • obtenir une configuration de départ raisonnable pour un nouveau serveur PostgreSQL ;
  • recalculer après un ajout de RAM ou de CPU ou une montée de version majeure ;
  • comparer les profils (web, OLTP, analytique) sur le même matériel ;
  • justifier le choix des paramètres en revue ou dans un runbook.

Questions fréquentes

pgtune envoie-t-il mes paramètres à un serveur ?

Non. Tous les calculs se font dans le navigateur et il n’y a pas d’API.

Quelles versions de PostgreSQL sont prises en charge ?

De la 14 à la 19. L’ensemble des paramètres et leurs valeurs dépendent de la version choisie.

Puis-je copier le résultat tel quel en production ?

Considérez-le comme un point de départ. Lisez les avertissements, appliquez-le sur une instance de test et observez les métriques sous charge réelle.

Pourquoi max_connections est-il bas même pour une grosse base ?

Chaque connexion consomme de la mémoire et work_mem est réparti entre elles. Un pooler comme PgBouncer vaut souvent mieux que des milliers de connexions directes.

Et si je ne connais pas le CPU ou les connexions ?

Laissez les champs vides : les valeurs sont choisies selon le profil et la RAM, et le résultat indique le nombre de connexions retenu.