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.
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é
- Ouvrez Prisma vers ERD et choisissez un exemple ou un document vide.
- 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.
- 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.
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])
}Modèles, champs et noms mis en correspondance
| Syntaxe | Signification |
|---|---|
| model User { ... } | Un modèle avec des champs scalaires et de relation. |
| String / Int / Boolean / DateTime / Decimal / Json / Bytes | Types 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. |
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.
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?
}É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.
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.
| Fournisseur | Conseils spécifiques aux connecteurs |
|---|---|
| PostgreSQL / CockroachDB | Les 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é. |
| MySQL | Pas 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é. |
| SQLite | Pas d'attributs de type @db natifs Prisma, de listes scalaires ou d'option de schémas de source de données (datasource). |
| SQL Server | Pas de blocs enum, de champs Json ou de listes scalaires. Les déclarations multi-schémas sont prises en charge. |
| MongoDB | Utilisez relationMode = "prisma", un mappage _id et des types scalaires/natifs ObjectId correspondants. Les blocs de types composites appartiennent à ce connecteur. |
Explorer, exporter et enregistrer
- 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à.
- 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.
- Exportez le diagramme au format PNG, SVG avec support d'image ou PDF pour un document ou une présentation.
- 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
| Symptôme | Quoi vérifier |
|---|---|
| Une relation présente un avertissement | Vé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 avertissement | Rendez 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 unique | Vé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 absente | Chaque 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 erreurs | Les 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 modifications | Enregistrez 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ée | Vé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.
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.