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 $2au lieu deOFFSET. 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.
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.