Aller à la documentation

VOS MODÈLES, VISUALISÉS

Prisma vers ERD : guide

Visualisez schema.prisma avec ses modèles, relations et noms mappés. Comprenez la syntaxe et corrigez les diagnostics.

schema.prisma → Diagramme EROuvrir Prisma vers ERD

Voir la structure de votre schéma Prisma

Collez schema.prisma dans l'éditeur pour visualiser les modèles, les champs scalaires, les clés, les énumérations, les index et les relations. La conversion s'exécute dans le navigateur et conserve des modèles lisibles lorsque les diagnostics nécessitent une attention particulière.

Cet outil visualise votre schéma. Il ne se connecte pas à votre source de données, n'exécute pas Prisma Client et n'applique pas de migrations.

Les exemples utilisent la syntaxe de source de données Prisma 6. Dans Prisma 7, conservez le fournisseur dans schema.prisma et configurez l'URL de connexion dans prisma.config.ts. Erd Go accepte une source de données composée uniquement du fournisseur ; collez le schéma ici, pas votre fichier de configuration ou vos identifiants.

Collez un schéma connecté

  1. Ouvrez Prisma vers ERD et choisissez un exemple ou un document vide.
  2. Collez le schéma ci-dessous, ou votre propre schema.prisma complet. Le fournisseur de source de données contrôle la validation spécifique au connecteur.
  3. Examinez le diagramme et les diagnostics, puis inspectez les modèles, les champs et les relations dans l'explorateur. Utilisez les contrôles de mise en page pour organiser le diagramme.
Prisma / Schéma Prisma connecté
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

model User {
  id    Int    @id @default(autoincrement())
  email String @unique
  posts Post[]
}

model Post {
  id       Int    @id @default(autoincrement())
  title    String
  authorId Int
  author   User   @relation(fields: [authorId], references: [id])

  @@index([authorId])
}
DATABASE_URL fait partie de l'exemple de schéma. Le visualiseur ne l'utilise pas pour établir une connexion à la base de données.

Modèles, champs et noms mis en correspondance

Modèles, champs et noms mis en correspondance
SyntaxeSignification
model User { ... }Un modèle avec des champs scalaires et de relation.
String / Int / Boolean / DateTime / Decimal / Json / BytesTypes de champs scalaires ; la prise en charge des connecteurs s'applique toujours.
String? / Post[]Champ optionnel / champ de liste.
@id / @@id([a, b])Clé primaire à champ unique ou composite.
@unique / @@unique([a, b])Contrainte d'unicité à champ unique ou composite.
@default(...) / @updatedAt / @db.VarChar(255)Valeurs par défaut, mise à jour des métadonnées et types natifs spécifiques au fournisseur.
@map("user_id") / @@map("users")Colonne mise en correspondance / nom de table de base de données.
enum Status { ... } / @@index([field])Valeurs d'énumération / index de modèle.
@@schema("public")Appartenance au schéma pour une source de données multi-schéma compatible.
Ne mélangez pas les types natifs et les fonctions par défaut de différents connecteurs. Les extraits de modèle uniquement sont permissifs ; une source de données complète active une validation de fournisseur plus stricte.

Relations et règles de clés

Une relation explicite utilise un champ de relation, des champs de clés étrangères scalaires et @relation(fields: [...], references: [...]). Incluez un champ de relation opposé sur l'autre modèle. Référencez une clé primaire ou une clé unique globale avec des types scalaires et natifs compatibles.

Si un scalaire de clé étrangère est optionnel, son champ de relation propriétaire doit également être optionnel. Une relation optionnelle peut posséder des scalaires obligatoires. Un propriétaire un-à-un nécessite @unique ou @@unique sur ses champs de clé étrangère, et le champ inverse sans ces scalaires doit être optionnel.

Utilisez le même nom de relation entre guimotes des deux côtés pour distinguer plusieurs liens entre les mêmes modèles ou une auto-relation. Les noms peuvent contenir de la ponctuation. Les noms de champs et les références de clés respectent la casse ; listez chaque champ de clé une fois et incluez chaque membre de clé composée.

Les liaisons implicites de type plusieurs-à-plusieurs (many-to-many) nécessitent un champ scalaire unique de niveau @id sur chaque modèle participant. Les identifiants composites, au niveau du bloc ou basés uniquement sur l'unicité génèrent un diagnostic plutôt qu'une relation virtuelle trompeuse. Utilisez un modèle de jointure explicite pour des champs supplémentaires, des clés complexes ou des actions référentielles.

Prisma / Relation un-à-un
model Profile {
  id     Int  @id @default(autoincrement())
  userId Int  @unique
  user   User @relation(fields: [userId], references: [id])
}

model User {
  id      Int      @id @default(autoincrement())
  profile Profile?
}
Les index uniques partiels apparaissent sous la forme PUQ. Leur unicité s'applique uniquement aux lignes correspondantes, de sorte qu'ils ne peuvent pas établir d'identité globale ni impliquer une cardinalité un-à-un.

Énumérations, clés composites et mappages de bases de données

Utilisez @@id et @@unique pour les clés multi-colonnes, @map pour les noms de champs et @@map pour les noms de tables. Pour un fournisseur multi-schéma compatible, répertoriez les schémas dans la source de données et attribuez les modèles avec @@schema. Le nom du modèle reste utile dans l'éditeur tandis que l'identité mappée est préservée pour la sortie de la base de données.

L'exemple PostgreSQL ci-dessous possède une clé primaire composite et un e-mail unique limité au locataire (tenant). Une relation explicite avec cette clé doit fournir tenantId et accountId dans le même ordre avec des types de champs compatibles.

Prisma / Schéma à clé composite mis en correspondance
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
  schemas  = ["identity"]
}

enum AccountState {
  ACTIVE
  DISABLED

  @@schema("identity")
}

model Account {
  tenantId  Int          @map("tenant_id")
  accountId Int          @map("account_id")
  email     String
  state     AccountState @default(ACTIVE)

  @@id([tenantId, accountId])
  @@unique([tenantId, email])
  @@map("accounts")
  @@schema("identity")
}

Fournisseurs et diagnostics récupérables

Les fournisseurs de sources de données pris en charge incluent PostgreSQL, MySQL, SQLite, SQL Server, MongoDB et CockroachDB. Le convertisseur vérifie les identités spécifiques au connecteur, les types natifs, les valeurs par défaut, les règles de relation et les collisions de noms mappés.

Les fournisseurs relationnels utilisent par défaut relationMode = "foreignKeys". MongoDB utilise relationMode = "prisma" et valide son mappage _id et ses exigences ObjectId. Ne supposez pas qu'un exemple relationnel peut être copié tel quel dans MongoDB.

Corrigez les champs de relation opposés manquants, les types de clés étrangères incompatibles, les cibles de clés invalides et les combinaisons de fournisseurs non prises en charge à l'aide des diagnostics. Les champs invalides mais lisibles restent visibles afin que vous puissiez réparer le schéma sur place.

Fournisseurs et diagnostics récupérables
FournisseurConseils spécifiques aux connecteurs
PostgreSQL / CockroachDBLes listes scalaires et les déclarations multi-schémas sont prises en charge ; les types natifs et les valeurs par défaut doivent correspondre au fournisseur sélectionné.
MySQLPas de listes scalaires ou d'option de schémas de source de données. La validation des actions référentielles suit le relationMode sélectionné.
SQLitePas d'attributs de type @db natifs Prisma, de listes scalaires ou d'option de schémas de source de données (datasource).
SQL ServerPas de blocs enum, de champs Json ou de listes scalaires. Les déclarations multi-schémas sont prises en charge.
MongoDBUtilisez relationMode = "prisma", un mappage _id et des types scalaires/natifs ObjectId correspondants. Les blocs de types composites appartiennent à ce connecteur.

Explorer, exporter et enregistrer

  1. Recherchez dans l'explorateur par modèle, champ, nom mappé, énumération ou relation. Sélectionnez une relation pour examiner ses champs, références, cardinalité et actions référentielles dans l'Inspecteur de relations ; focalisez l'une ou l'autre extrémité à partir de là.
  2. Utilisez les emplacements de diagnostic pour accéder à la source nécessitant une attention particulière. Ajustez la mise en page et les préférences d'affichage sur l'ERD.
  3. Exportez le diagramme au format PNG, SVG avec support d'image ou PDF pour un document ou une présentation.
  4. Connectez-vous pour enregistrer un fichier Prisma avec son contexte de source et de rendu. Enregistrez les modifications avant de partager un lien public en lecture seule. Un spectateur partagé ne reçoit pas l'accès en modification de la source.

Résoudre les problèmes d'un schéma Prisma

Résoudre les problèmes d'un schéma Prisma
SymptômeQuoi vérifier
Une relation présente un avertissementVérifiez le champ opposé correspondant et le nom de la relation, les types scalaires/natifs compatibles, la clé référencée globalement unique et les champs/références présents uniquement du côté propriétaire.
Une relation un-à-un présente un avertissementRendez le groupe de clés étrangères propriétaire globalement unique et la relation inverse optionnelle. Si un scalaire propriétaire autorise les valeurs NULL, rendez sa relation optionnelle également.
Une clé composée n'est pas affichée comme globalement uniqueVérifiez l'absence, la répétition, le caractère optionnel ou la casse différente des noms de champs. Un prédicat unique partiel est affiché sous la forme PUQ au lieu de UQ global.
Une arête implicite de type plusieurs-à-plusieurs est absenteChaque modèle nécessite un champ scalaire unique au niveau du champ @id. Utilisez un modèle de jointure explicite pour les identifiants composites ou les attributs de relation.
Le diagramme s'affiche avec des erreursLes champs lisibles sont délibérément conservés. Réparez les diagnostics avant de considérer le schéma comme valide pour son fournisseur de base de données.
La disposition enregistrée ne reflète pas les nouvelles modificationsEnregistrez le contexte de la source et du moteur actuel avant de partager ou de recharger ; les spectateurs publics voient la version enregistrée.
La modification de la source est désactivéeVérifiez la propriété du document, la connexion et si le chargement cloud est terminé. Les erreurs de chargement récupérables proposent Réessayer et Ouvrir des fichiers.

Générer Prisma avec le bon fournisseur

Copiez ce guide en tant que prompt pour l'IA, nommez votre version de Prisma et votre fournisseur, puis indiquez vos modèles et vos règles de gestion. Demandez à l'assistant de préserver les noms @map et @@map existants tout en modifiant le schéma.

Collez le Prisma renvoyé dans l'éditeur et examinez les diagnostics avant de l'utiliser ailleurs. Un diagramme rendu ne remplace pas la validation du fournisseur ou l'examen d'une migration.

AI request / Requête Prisma AI
Generate a PostgreSQL Prisma schema for User, Project, and Membership.
Use an explicit Membership join model with a composite key.
Include both sides of every relation and compatible foreign-key types.
Preserve these database table names: users, projects, memberships.