Formations — 1 037 leçons en français

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 TABLE est 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 SELECT avant l'INSERT laisse passer deux requêtes simultanées.

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.