PostgreSQL derrière PgBouncer : Prisma, Django, Rails et vos migrations, avec votre agent IA

Prérequis

• Une appli en ligne sur while, avec sa base PostgreSQL.
• Votre agent IA, branché à while par MCP.

Étape 1 : Demandez une vérification

Votre agent 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 agent lance aussi à la demande. Elle reçoit l’adresse directe de la base dans DB_MAIN_DIRECT_URL.

Ce que fait votre agent

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¹. Pour régler la session, votre agent 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

Votre agent coupe les curseurs côté serveur :

DATABASES["default"]["DISABLE_SERVER_SIDE_CURSORS"] = True

Régler Rails

Votre agent coupe les verrous consultatifs des migrations :

production:
  primary:
    url: <%= ENV["DATABASE_URL"] %>
    advisory_locks: false

Garder Prisma tel quel

Votre agent laisse Prisma sur DATABASE_URL, migrations comprises : rien à changer. Il 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

Votre agent 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

• Mettre en ligne une API Node.js et sa base PostgreSQL
• Mettre en ligne une appli Django
• Remettre votre base à un instant précis