Zur Dokumentation springen

IHRE MODELLE, VISUALISIERT

Prisma zu ERD-Anleitung

Visualisieren Sie schema.prisma mit Modellen, Beziehungen und zugeordneten Namen. Verstehen Sie die Syntax und beheben Sie Diagnosehinweise.

schema.prisma → ER-DiagrammPrisma zu ERD öffnen

Sehen Sie sich die Struktur Ihres Prisma-Schemas an

Fügen Sie schema.prisma in den Editor ein, um Modelle, Skalarfelder, Schlüssel, Enums, Indizes und Beziehungen zu visualisieren. Die Konvertierung erfolgt im Browser und behält lesbare Modelle bei, wenn Diagnosen Aufmerksamkeit erfordern.

Dieses Tool visualisiert Ihr Schema. Es stellt keine Verbindung zu Ihrer Datenquelle her, führt keinen Prisma Client aus und wendet keine Migrationen an.

Die Beispiele verwenden die Prisma 6-Datenquellen-Syntax. Behalten Sie in Prisma 7 den Provider in schema.prisma bei und konfigurieren Sie die Verbindungs-URL in prisma.config.ts. Erd Go akzeptiert eine reine Provider-Datenquelle; fügen Sie das Schema hier ein, nicht Ihre Konfigurationsdatei oder Anmeldedaten.

Ein verbundenes Schema einfügen

  1. Öffnen Sie Prisma zu ERD und wählen Sie ein Beispiel oder ein leeres Dokument.
  2. Fügen Sie das Schema unten oder Ihr eigenes vollständiges schema.prisma ein. Der Datenquellenanbieter steuert die konnektorspezifische Validierung.
  3. Überprüfen Sie das Diagramm und die Diagnosen und untersuchen Sie dann Modelle, Felder und Beziehungen im Explorer. Verwenden Sie Layout-Steuerelemente, um das Diagramm anzuordnen.
Prisma / Verbundenes Prisma-Schema
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 ist Teil des Schema-Beispiels. Der Visualisierer verwendet sie nicht, um eine Datenbankverbindung herzustellen.

Modelle, Felder & zugeordnete Namen

Modelle, Felder & zugeordnete Namen
SyntaxBedeutung
model User { ... }Ein Modell mit Skalar- und Beziehungsfeldern.
String / Int / Boolean / DateTime / Decimal / Json / BytesSkalare Feldtypen; Connector-Unterstützung gilt weiterhin.
String? / Post[]Optionales Feld / Listenfeld.
@id / @@id([a, b])Einzel- oder zusammengesetzter Primärschlüssel.
@unique / @@unique([a, b])Einzel- oder zusammengesetzte Eindeutigkeitsbedingung.
@default(...) / @updatedAt / @db.VarChar(255)Standardwerte, Aktualisierungsmetadaten und anbieterspezifische native Typen.
@map("user_id") / @@map("users")Abgebildete Spalte / Datenbanktabellenname.
enum Status { ... } / @@index([field])Enum-Werte / Modellindizes.
@@schema("public")Schema-Zugehörigkeit für eine kompatible Multi-Schema-Datenquelle.
Mischen Sie keine nativen Typen und Standardfunktionen verschiedener Konnektoren. Nur-Modell-Schnipsel sind permissiv; eine vollständige Datenquelle ermöglicht eine strengere Anbietervalidierung.

Beziehungen & Schlüsselregeln

Eine explizite Relation verwendet ein Relationsfeld, skalare Fremdschlüsselfelder und @relation(fields: [...], references: [...]). Fügen Sie ein gegenüberliegendes Relationsfeld im anderen Modell hinzu. Referenzieren Sie einen Primärschlüssel oder einen global eindeutigen Schlüssel mit kompatiblen skalaren und nativen Typen.

Wenn ein beliebiger Fremdschlüssel-Skalar optional ist, muss auch sein besitzendes Beziehungsfeld optional sein. Eine optionale Beziehung kann erforderliche Skalare haben. Ein Eins-zu-Eins-Besitzer benötigt @unique oder @@unique für seine Fremdschlüssel-Felder, und das inverse Feld ohne diese Skalare muss optional sein.

Verwende denselben in Anführungszeichen gefassten Beziehungsnamen auf beiden Seiten, um mehrere Verknüpfungen zwischen denselben Modellen oder eine Selbstbeziehung zu unterscheiden. Namen können Satzzeichen enthalten. Feldnamen und Schlüssellinks unterscheiden Groß- und Kleinschreibung; liste jedes Schlüsselfeld einmal auf und schließe jedes Mitglied eines zusammengesetzten Schlüssels ein.

Implicite relationale Many-to-Many-Kanten erfordern ein skalares Feld-basiertes @id auf jedem beteiligten Modell. Zusammengesetzte, Block-basierte oder nur eindeutige Identifikatoren erzeugen eine Diagnose anstelle einer irreführenden virtuellen Beziehung. Verwenden Sie ein explizites Join-Modell für zusätzliche Felder, komplexe Schlüssel oder referenzielle Aktionen.

Prisma / Eins-zu-Eins-Beziehung
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?
}
Teilweise eindeutige Indizes werden als PUQ angezeigt. Ihre Eindeutigkeit gilt nur für übereinstimmende Zeilen, sodass sie keine globale Identität begründen oder eine Eins-zu-Eins-Kardinalität implizieren können.

Enums, zusammengesetzte Schlüssel und Datenbank-Mappings

Verwenden Sie @@id und @@unique für mehrspaltige Schlüssel, @map für Feldnamen und @@map für Tabellennamen. Für einen kompatiblen Multi-Schema-Anbieter listen Sie Schemas in der Datenquelle auf und weisen Sie Modelle mit @@schema zu. Der Modellname bleibt im Editor nützlich, während die zugeordnete Identität für die Datenbankausgabe erhalten bleibt.

Das folgende PostgreSQL-Beispiel hat einen zusammengesetzten Primärschlüssel und eine mandantenbezogene eindeutige E-Mail. Eine explizite Beziehung zu diesem Schlüssel muss tenantId und accountId in der gleichen Reihenfolge mit kompatiblen Feldtypen bereitstellen.

Prisma / Abgebildetes zusammengesetztes Schlüssel-Schema
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")
}

Anbieter und wiederherstellbare Diagnosen

Zu den unterstützten Datenquellen-Anbietern gehören PostgreSQL, MySQL, SQLite, SQL Server, MongoDB und CockroachDB. Der Konverter prüft Connector-spezifische Identitäten, native Typen, Standardwerte, Beziehungsregeln und Kollisionen bei zugeordneten Namen.

Relationale Provider verwenden standardmäßig relationMode = "foreignKeys". MongoDB verwendet relationMode = "prisma" und validiert seine _id-Zuordnung sowie ObjectId-Anforderungen. Gehen Sie nicht davon aus, dass ein relationales Beispiel unverändert auf MongoDB übertragen werden kann.

Beheben Sie fehlende gegenüberliegende Beziehungsfelder, inkompatible Fremdschlüsseltypen, ungültige Schlüsselziele und nicht unterstützte Anbieterkombinationen mithilfe der Diagnosen. Ungültige, aber lesbare Felder bleiben sichtbar, sodass Sie das Schema direkt reparieren können.

Anbieter und wiederherstellbare Diagnosen
AnbieterAnleitung für bestimmte Anschlüsse
PostgreSQL / CockroachDBSkalare Listen und Multi-Schema-Deklarationen werden unterstützt; native Typen und Standardwerte müssen mit dem ausgewählten Anbieter übereinstimmen.
MySQLKeine Skalarlisten oder Datenbankschema-Option. Die Validierung von referenziellen Aktionen folgt dem ausgewählten relationMode.
SQLiteKeine nativen Prisma @db Typattribute, Skalarlisten oder Datenbankschema-Optionen.
SQL ServerKeine Enum-Blöcke, Json-Felder oder Skalarlisten. Multi-Schema-Deklarationen werden unterstützt.
MongoDBVerwenden Sie relationMode = "prisma", ein _id-Mapping und passende ObjectId-Skalar-/nativ-Typen. Blöcke für zusammengesetzte Typen gehören zu diesem Verbinder.

Erkunden, exportieren & Speichern

  1. Durchsuchen Sie den Explorer nach Modell, Feld, zugeordnetem Namen, Enum oder Relation. Wählen Sie eine Relation aus, um deren Felder, Referenzen, Kardinalität und referenzielle Aktionen im Relations-Inspektor zu überprüfen; fokussieren Sie von dort aus einen der beiden Endpunkte.
  2. Verwenden Sie Diagnose-Standorte, um zu der Quelle zu springen, die Aufmerksamkeit erfordert. Passen Sie Layout- und Anzeigeeinstellungen auf dem ERD an.
  3. Exportieren Sie das Diagramm als PNG, bildunterstützte SVG oder PDF für ein Dokument oder eine Präsentation.
  4. Melden Sie sich an, um eine Prisma-Datei mit ihrem Quell- und Renderer-Kontext zu speichern. Speichern Sie Bearbeitungen, bevor Sie einen schreibgeschützten öffentlichen Link teilen. Ein geteilter Betrachter erhält keinen Zugriff auf die Quellbearbeitung.

Fehlerbehebung bei einem Prisma-Schema

Fehlerbehebung bei einem Prisma-Schema
SymptomWas zu überprüfen ist
Eine Beziehung hat eine WarnungPrüfe das übereinstimmende gegenüberliegende Feld und den Beziehungsnamen, kompatible Skalar-/Native-Typen, global eindeutigen referenzierten Schlüssel und Felder/Referenzen nur auf der Besitztseite.
Eine Eins-zu-eins-Beziehung hat eine WarnungMachen Sie die besitzende Fremdschlüsselgruppe global eindeutig und die umgekehrte Beziehung optional. Wenn ein besitzender Skalar nullbar ist, machen Sie auch seine Beziehung optional.
Ein zusammengesetzter Schlüssel wird nicht als global eindeutig angezeigtÜberprüfen Sie auf fehlende, wiederholte, optionale oder unterschiedlich großgeschriebene Feldnamen. Ein partielles eindeutiges Prädikat wird als PUQ anstelle von globalem UQ angezeigt.
Eine implizite Many-to-Many-Kante fehltJedes Modell benötigt ein skalares feldweises @id. Verwenden Sie ein explizites Join-Modell für zusammengesetzte Identifizierer oder Beziehungsattribute.
Das Diagramm wird mit Fehlern gerendertLesbare Felder werden bewusst beibehalten. Reparieren Sie die Diagnosen, bevor Sie das Schema als gültig für seinen Datenbankanbieter betrachten.
Das gespeicherte Layout spiegelt neue Bearbeitungen nicht widerSpeichern Sie den aktuellen Quell- und Renderer-Kontext vor dem Teilen oder Neuladen; öffentliche Betrachter sehen die gespeicherte Version.
Quellbearbeitung ist deaktiviertÜberprüfen Sie den Dokumentbesitz, die Anmeldung und ob das Laden in der Cloud abgeschlossen ist. Behebbare Ladefehler bieten "Wiederholen" und "Dateien öffnen" an.

Prisma mit dem richtigen Provider generieren

Kopieren Sie diesen Leitfaden als KI-Prompt, benennen Sie Ihre Prisma-Version und Ihren Provider, und geben Sie dann Ihre Modelle und Geschäftsregeln an. Bitten Sie den Assistenten, bestehende @map- und @@map-Namen beizubehalten, während das Schema geändert wird.

Fügen Sie das zurückgegebene Prisma in den Editor ein und überprüfen Sie die Diagnosen, bevor Sie es woanders verwenden. Ein gerendertes Diagramm ersetzt keine Anbieterüberprüfung oder Migrationsüberprüfung.

AI request / Prisma-KI-Anfrage
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.