Aller au contenu

PostgreSQL derrière PgBouncer : Prisma, Django, Rails et vos migrations (2026)

Votre base PostgreSQL sur while passe par PgBouncer, pour tenir des centaines de clients à la fois. Votre IA sait ce que ça change pour votre code, et le règle pour vous.

Par Aloïs Oddon, cofondateur de Nextmap. Faits relevés le 19 novembre 2026.

Voir en Markdown

PostgreSQL derrière PgBouncer : Prisma, Django, Rails et vos migrations : PostgreSQL derrière PgBouncer avec Claude Code, Cursor ou Codex, sur while, hébergé en France

Ce qu’il faut retenir. Votre base sur while passe par PgBouncer en mode transaction. Ce que votre IA règle pour Prisma, Django ou Rails, et où vont les migrations. Ce qui compte, comme supprimer une base, attend la validation d’une personne.

Prérequis

  • Une appli sur while, avec sa base PostgreSQL.
  • Votre IA, connecté à while par MCP.

Étape 1 : Demandez une vérification

Vous, à votre IA : Vérifie que notre code marche derrière PgBouncer.

Votre IA relit votre code et vos réglages de base, et corrige ce qui suppose de garder la même connexion à la base d’une requête à l’autre.

Étape 2 : Ce qui a besoin d’une session passe à part

Ce qui a besoin d’une session entière, comme pg_restore ou une migration qui fait des SET, tourne dans une tâche, que votre IA lance aussi à la demande. Elle reçoit l’adresse directe de la base dans DB_MAIN_DIRECT_URL.

Ce que fait votre IA

En mode transaction, chaque transaction peut prendre une autre connexion. Les requêtes préparées sont suivies : Prisma et node-postgres marchent sans réglage. Un SET de session, un verrou consultatif ou un curseur côté serveur, eux, ne passent pas d’une transaction à l’autre1. Pour régler la session, votre IA utilise SET LOCAL, dans une transaction :

server.js
const client = await db.connect();
try {
  await client.query('BEGIN');
  await client.query("SET LOCAL statement_timeout = '5s'");
  await client.query('SELECT count(*) FROM commandes');
  await client.query('COMMIT');
} catch (e) {
  await client.query('ROLLBACK');
  throw e;
} finally {
  client.release();
}
PostgreSQL derrière PgBouncer avec while : les identifiants gardés hors de portée de l'IA, chaque appel noté dans l'historique, la validation d'une personne pour ce qui compte et la sauvegarde de chaque jour, en France
Autour de chaque appli, while garde les identifiants, l'historique, les validations et les sauvegardes.

Régler Django

Vous, à votre IA : Règle Django pour PgBouncer.

Votre IA coupe les curseurs côté serveur :

settings.py
DATABASES["default"]["DISABLE_SERVER_SIDE_CURSORS"] = True

Régler Rails

Vous, à votre IA : Règle Rails pour PgBouncer.

Votre IA coupe les verrous consultatifs des migrations :

config/database.yml
production:
  primary:
    url: <%= ENV["DATABASE_URL"] %>
    advisory_locks: false

Garder Prisma tel quel

Vous, à votre IA : Utilise Prisma pour les migrations.

Votre IA laisse Prisma sur DATABASE_URL, migrations comprises : rien à changer. Elle ne déclare pas de directUrl, que Prisma réclamerait au démarrage avec l’erreur P1012 : l’adresse directe n’est donnée qu’aux tâches.

Trouver les requêtes lentes

Vous, à votre IA : Quelles requêtes ralentissent la base ?

Votre IA lit les requêtes les plus fréquentes et les plus lentes de votre base, relevées par pg_stat_statements.

Dans la doc : Bases PostgreSQL.

Prochaines étapes

Sources

  1. PgBouncer, ce que permet chaque mode de regroupement, consulté le 2 novembre 2026

Questions

Faut-il ?pgbouncer=true pour Prisma ?

Non : PgBouncer suit les requêtes préparées, et l’adresse de DATABASE_URL marche telle quelle.

Puis-je me connecter sans PgBouncer ?

Une tâche, oui : elle reçoit l’adresse directe dans DB_MAIN_DIRECT_URL. Votre appli passe toujours par PgBouncer.

Combien de clients en même temps ?

Selon la taille de la base : 200 en S, la taille par défaut, 400 en M, 600 en L, 800 en XL.

Où tournent mon appli et ses données ?

En France, chez Nextmap. La base est sauvegardée chaque jour, avec un retour possible sur 14 jours, une fois qu’une personne a validé.

Mon IA voit-elle mes identifiants ?

Non. Vous les collez dans while, l’appli s’en sert, et votre IA ne les voit jamais. Chaque appel est noté.

Donnez la phrase à votre IA, elle s’occupe du reste

À donner à votre IA

Lis while.sh/agents et aide-moi à démarrer avec while.

Copier la phrase

En 3 minutes, sans inscription, l’outil a son adresse. Pour le garder, créez votre compte.

Pour un projet d’entreprise, écrivez à l’équipe de while : hello@while.sh