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.
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 :
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();
}

Régler Django
Vous, à votre IA : Règle Django pour PgBouncer.
Votre IA coupe les curseurs côté serveur :
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 :
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
- PgBouncer, ce que permet chaque mode de regroupement, consulté le 2 novembre 2026