Formations — 1 037 leçons en français

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 finally manquant. 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.

Lire l'explication détaillée et faire le quiz →

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.