---
title: "PgBouncer et PostgreSQL en 2026 : Prisma, Django, Rails et migrations"
url: https://while.sh/fr/guides/pgbouncer-postgresql/
author: "Aloïs Oddon, cofondateur de Nextmap"
updated: 2026-11-19
---

# 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.

> **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'autre (source 1). Pour régler la session, votre IA utilise `SET LOCAL`, dans une transaction :

```js titre="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();
}
```

<figure class="illus"><img src="/illustrations/guide-fonction-garde-1200.webp" srcset="/illustrations/guide-fonction-garde-768.webp 768w, /illustrations/guide-fonction-garde-1200.webp 1200w" sizes="(min-width: 48rem) 46rem, 100vw" width="1536" height="1024" loading="lazy" decoding="async" alt="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" /><figcaption>Autour de chaque appli, while garde les identifiants, l'historique, les validations et les sauvegardes.</figcaption></figure>

## Régler Django

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

Votre IA coupe les curseurs côté serveur :

```python titre="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 :

```yaml titre="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.

## Prochaines étapes

- [Mettre en production une API Node.js et sa base PostgreSQL](/fr/guides/api-node-postgresql/)
- [Mettre en production une appli Django](/fr/guides/appli-django/)
- [Remettre votre base à un instant précis](/fr/guides/restaurer-une-base/)

## Sources

1. [PgBouncer, ce que permet chaque mode de regroupement](https://www.pgbouncer.org/features.html), 2026-11-02

## 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é.
