Formations — 1 037 leçons en français

Accueil › Node.js › ORM, constructeur de requêtes, ou SQL

ORM, constructeur de requêtes, ou SQL

ORM et migrationsintermediaire

Trois niveaux d'abstraction au-dessus de la base, et chacun se paie.

L'ORM

const commandes = await db.commande.findMany({
  where: { clientId: id, statut: "payee" },
  include: { lignes: { include: { produit: true } } },
});

Vous décrivez le résultat, pas la requête. Le code répétitif disparaît : plus de INSERT à dix colonnes à maintenir, plus de conversion de lignes en objets. En échange, vous ne savez pas quel SQL part. Ce include imbriqué peut devenir une jointure, deux requêtes, ou cinquante.

Le constructeur de requêtes

const lignes = await db
  .select({ id: commandes.id, total: commandes.total })
  .from(commandes)
  .innerJoin(clients, eq(commandes.clientId, clients.id))
  .where(eq(commandes.statut, "payee"));

La forme de la requête reste la vôtre : vous voyez la jointure, les colonnes rendues, l'ordre. Vous gardez le contrôle, et vous écrivez plus de lignes.

Le SQL brut

const { rows } = await pool.query(
  `SELECT date_trunc('month', creee_le) AS mois,
          count(*) AS commandes,
          sum(total) FILTER (WHERE statut = 'payee') AS encaisse
     FROM commandes
    WHERE creee_le >= $1
    GROUP BY 1 ORDER BY 1`,
  [debut],
);

Pour un rapport, c'est imbattable. Essayez de réécrire ce FILTER dans une API d'ORM : vous y passerez plus de temps qu'à l'écrire, et le résultat sera moins lisible.

Le choix réel

Besoin Niveau adapté
Créer, lire, modifier une entité ORM
Requête sur mesure, colonnes choisies constructeur
Rapport, agrégation, fenêtrage SQL brut

Ce n'est pas un choix de projet, c'est un choix par requête. La question qui compte lors du choix d'un outil est donc : me laisse-t-il écrire du SQL quand j'en ai besoin ?

Les termes à connaître

ORM

Une couche qui fait correspondre des tables à des objets. Vous décrivez ce que vous voulez, elle écrit le SQL. Vous écrivez moins de code, et vous prévoyez moins bien la requête produite.

Constructeur de requêtes

Une API qui compose du SQL morceau par morceau. La forme de la requête reste la vôtre ; seule l'écriture est assistée.

SQL brut

La requête écrite à la main, passée en paramètres liés. Rien ne s'interpose, donc rien ne vous surprend.

Problème N+1

Une requête pour la liste, puis une requête par élément pour ses relations. Cent commandes deviennent cent une requêtes, et la cause est invisible dans le code.

Requête paramétrée

Les valeurs voyagent séparément du texte de la requête. C'est la seule protection réelle contre l'injection SQL, et les trois niveaux d'abstraction la fournissent.

Abstraction fuyante

Une couche qui cache le SQL jusqu'au jour où il faut le lire pour comprendre une lenteur. L'abstraction n'a pas disparu : elle est devenue une dette de compréhension.

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.