Accueil › Node.js › Le schéma comme source de vérité
Le schéma comme source de vérité
ORM et migrationsintermediaire
Une table, un type TypeScript, un formulaire de validation : trois descriptions de la même chose. Écrites séparément, elles divergent. Le schéma est la description dont toutes les autres doivent descendre.
Le schéma déclare l'état voulu
model Client {
id String @id @default(uuid())
email String @unique
telephone String?
creeLe DateTime @default(now())
commandes Commande[]
}
export const clients = pgTable("clients", {
id: uuid("id").primaryKey().defaultRandom(),
email: text("email").notNull().unique(),
telephone: text("telephone"),
creeLe: timestamp("cree_le").notNull().defaultNow(),
});
Deux syntaxes, une même idée : vous décrivez l'état voulu, pas les ordres pour y arriver. C'est l'outil qui calcule la différence avec la base.
Les types en descendent
import type { Client } from "@prisma/client";
// ou
type Client = typeof clients.$inferSelect;
function afficher(c: Client) {
return c.telephone.trim(); // ⛔ ne compile pas : string | null
}
Le ? du schéma devient | null dans le type. Personne ne l'a écrit deux
fois, donc personne ne peut l'oublier une fois.
Ce qu'une table garantit et qu'un type ne garantit pas
| Déclaré dans | Protège contre |
|---|---|
| le type TypeScript | une faute de votre code, à la compilation |
| la table | toute écriture, d'où qu'elle vienne |
Un @unique est tenu par la base. Un SELECT avant l'INSERT ne l'est pas :
deux requêtes simultanées passent toutes les deux le test et insèrent toutes
les deux.
Les termes à connaître
- Schéma déclaratif
Un fichier qui décrit l'état voulu des tables. L'outil compare cet état à la base et en déduit les changements à écrire.
- Types dérivés
Les types TypeScript produits à partir du schéma. Ils ne sont jamais écrits à la main, donc ils ne peuvent pas mentir sur la forme de la table.
- Introspection
Lire une base existante pour en générer le schéma. C'est par là qu'on commence sur un projet qui a déjà des données.
- Dérive de schéma
L'écart entre ce que le fichier décrit et ce que la base contient. Elle apparaît dès qu'un
ALTER TABLEest passé à la main en production.- Colonne nullable
Une colonne qui accepte
NULL. Le schéma le dit, le type dérivé le dit, et le code est obligé de traiter l'absence.- Valeur par défaut côté base
Un défaut déclaré dans la table, donc appliqué même par une insertion qui ne passe pas par votre code. Un défaut côté application ne protège que votre code.
- Contrainte d'unicité
Une garantie que seule la base peut tenir. Vérifier l'unicité par un
SELECTavant l'INSERTlaisse passer deux requêtes simultanées.
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.