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