Accueil › Node.js › La réserve de connexions
La réserve de connexions
Parler à une base de donnéesintermediaire
Ouvrir une connexion PostgreSQL coûte un aller-retour réseau, une authentification, et la création d'un processus côté serveur. On ne le fait pas par requête : on ouvre un ensemble de connexions à l'avance et on les réutilise.
import { Pool } from "pg";
// L'URL de connexion vient de l'environnement, jamais du code.
export const pool = new Pool({
connectionString: process.env.DATABASE_URL,
max: 10,
idleTimeoutMillis: 30_000,
connectionTimeoutMillis: 5_000,
});
Deux façons d'exécuter une requête
// 1. La réserve emprunte et rend pour vous. À préférer.
const { rows } = await pool.query("SELECT id, nom FROM clients WHERE id = $1", [id]);
// 2. Vous empruntez vous-même. Nécessaire pour une transaction.
const client = await pool.connect();
try {
await client.query("SELECT 1");
} finally {
client.release(); // ⛔ sans ce finally, la connexion est perdue
}
La taille de la réserve est le vrai facteur limitant
Avec max: 10, votre API exécute au plus dix requêtes simultanément, quel
que soit le nombre de requêtes HTTP entrantes. Les autres attendent. Un serveur
Node qui tient dix mille connexions ouvertes reste limité par ces dix
connexions à la base — et c'est presque toujours là que la latence apparaît
sous charge, pas dans le processeur.
Le symptôme qu'il faut reconnaître
Toutes les requêtes expirent. La base est au repos : aucune requête lente,
aucun verrou. C'est une fuite de connexion : un finally oublié quelque part,
et la réserve s'est vidée une requête à la fois jusqu'au blocage complet.
Les termes à connaître
- Pilote
La bibliothèque qui parle le protocole de la base. Pour PostgreSQL en Node, c'est
pg: il ouvre une socket, sérialise les requêtes, décode les résultats. Il ne sait rien de votre modèle de données.- Réserve de connexions
Un ensemble fixe de connexions ouvertes à l'avance et réutilisées. On emprunte, on exécute, on rend. Ouvrir une connexion coûte un aller-retour réseau et une authentification.
- Connexion empruntée
Une connexion sortie de la réserve et pas encore rendue. Pendant ce temps, personne d'autre ne peut l'utiliser.
- File d'attente
Quand toutes les connexions sont empruntées, les demandes suivantes attendent. C'est normal sous charge, et pathologique quand ça ne se résorbe jamais.
- Fuite de connexion
Une connexion empruntée et jamais rendue, en général un
finallymanquant. La réserve se vide une fuite à la fois, puis l'API se bloque entièrement — base de données au repos.- `max`
La taille de la réserve. Facteur limitant réel du débit d'une API, bien avant le processeur du serveur Node, et bien plus souvent qu'on ne le croit.
- `max_connections`
La limite côté PostgreSQL, pour tous les clients confondus. La somme des réserves de toutes vos instances doit rester en dessous.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.