Formations — 1 037 leçons en français

Accueil › Node.js › Les pièges de performance

Les pièges de performance

Parler à une base de donnéesintermediaire

Les problèmes de performance d'une API Node viennent rarement de requêtes lentes. Ils viennent de requêtes nombreuses.

Le N+1

// ⛔ 1 + 50 allers-retours, séquentiels
const { rows: commandes } = await pool.query("SELECT id FROM commandes LIMIT 50");

for (const commande of commandes) {
  const { rows } = await pool.query(
    "SELECT * FROM lignes_commande WHERE commande_id = $1",
    [commande.id],
  );
  commande.lignes = rows;
}

Chaque requête est instantanée. Le coût, c'est la latence multipliée par cinquante. En développement, avec dix lignes et une base locale, la route répond en vingt millisecondes : les tests passent. En production, avec mille lignes et trois millisecondes de réseau, elle met trois secondes.

// ✅ 2 allers-retours, quel que soit le nombre de commandes
const { rows: commandes } = await pool.query("SELECT id FROM commandes LIMIT 50");
const ids = commandes.map((c) => c.id);

const { rows: lignes } = await pool.query(
  "SELECT * FROM lignes_commande WHERE commande_id = ANY($1)",
  [ids],
);

const parCommande = new Map(commandes.map((c) => [c.id, []]));
for (const ligne of lignes) parCommande.get(ligne.commande_id).push(ligne);

Les délais d'attente

const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  statement_timeout: 5_000,            // la base abandonne d'elle-même
  connectionTimeoutMillis: 2_000,
});

Le délai du client HTTP n'arrête pas la requête : elle continue de travailler et de tenir une connexion. Réglez statement_timeout plus court que le délai de votre client, pour que la base abandonne la première et rende la connexion.

Les termes à connaître

N+1 requêtes

Une requête pour obtenir N éléments, puis une requête par élément pour ses dépendances. Soit N+1 allers-retours là où deux suffisaient. Invisible sur dix lignes de test, fatal sur mille en production.

Chargement groupé

Remplacer N requêtes par une seule qui prend tous les identifiants — WHERE id = ANY($1) — puis regrouper les résultats en mémoire. Deux allers-retours, quel que soit N.

Aller-retour

Un échange complet avec la base. Même une requête instantanée coûte la latence du réseau. C'est la multiplication de ce coût fixe qui tue, pas le travail de la base.

`statement_timeout`

Le délai au-delà duquel PostgreSQL interrompt lui-même une requête et renvoie 57014. Le seul délai qui libère réellement la connexion.

Délai client

Le délai au bout duquel l'appelant HTTP renonce. Il ne dit rien à la base, qui continue de travailler pour une réponse que personne ne lira.

Pagination par curseur

Paginer avec WHERE id > $1 ORDER BY id LIMIT $2 au lieu de OFFSET. Le coût ne dépend plus du numéro de page, et le résultat reste stable.

Index

La structure qui évite de lire toute la table. Sans index sur la colonne filtrée, une requête rapide sur mille lignes devient inacceptable sur un million.

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.