Hoppa till dokumentationen

DINA MODELLER, VISUALISERADE

Prisma till ERD: guide

Visualisera schema.prisma med modeller, relationer och mappade namn. Förstå syntaxen och rätta diagnostiska anmärkningar.

schema.prisma → ER-diagramÖppna Prisma till ERD

Se strukturen i ditt Prisma-schema

Klistra in schema.prisma i redigeraren för att visualisera modeller, skalära fält, nycklar, enums, index och relationer. Konvertering körs i webbläsaren och behåller läsbara modeller när diagnostik behöver uppmärksamhet.

Detta verktyg visualiserar ditt schema. Det ansluter inte till din datakälla, kör Prisma Client eller tillämpar migreringar.

Exemplen använder Prisma 6-datakällsyntax. I Prisma 7, behåll providern i schema.prisma och konfigurera anslutnings-URL:en i prisma.config.ts. Erd Go accepterar en datakälla med endast provider; klistra in schemat här, inte din konfigurationsfil eller dina inloggningsuppgifter.

Klistra in ett anslutet schema

  1. Öppna Prisma till ERD och välj ett exempel eller ett tomt dokument.
  2. Klistra in schemat nedan, eller ditt eget fullständiga schema.prisma. Datakällans leverantör styr anslutningsspecifik validering.
  3. Granska diagrammet och diagnostiken, inspektera sedan modeller, fält och relationer i utforskaren. Använd layoutkontroller för att ordna diagrammet.
Prisma / Anslutet 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 är en del av schemaexemplet. Visualiseraren använder den inte för att upprätta en databasanslutning.

Modeller, fält & mappade namn

Modeller, fält & mappade namn
SyntaxBetydelse
model User { ... }En modell med skalära fält och relationsfält.
String / Int / Boolean / DateTime / Decimal / Json / BytesSkalära fälttyper; anslutningsstöd gäller fortfarande.
String? / Post[]Valfritt fält / listfält.
@id / @@id([a, b])Enkelt fält / sammansatt primärnyckel.
@unique / @@unique([a, b])Enkelt fält / sammansatt unikt villkor.
@default(...) / @updatedAt / @db.VarChar(255)Standardvärden, uppdatera metadata och leverantörsspecifika inbyggda typer.
@map("user_id") / @@map("users")Mappat kolumn- / databastabellnamn.
enum Status { ... } / @@index([field])Enum-värden / modellindex.
@@schema("public")Schemamedlemskap för en kompatibel datakälla med flera scheman.
Blanda inte inbyggda typer och standardfunktioner från olika kopplingar. Snippets som endast är för modellen är tillåtande; en komplett datakälla möjliggör striktare leverantörsvalidering.

Relationer & nyckelregler

En explicit relation använder ett relationsfält, skalära främmande nyckelfält och @relation(fields: [...], references: [...]). Inkludera ett motsatt relationsfält på den andra modellen. Referera till en primärnyckel eller globalt unik nyckel med kompatibla skalära och inbyggda typer.

Om någon skalär för främmande nyckel är valfri, måste dess ägande relationsfält också vara valfritt. En valfri relation kan ha obligatoriska skalärer. En en-till-en-ägare behöver @unique eller @@unique på sina främmande nyckelfält, och det inversa fältet utan dessa skalärer måste vara valfritt.

Använd samma citerade relationsnamn på båda sidor för att skilja mellan flera länkar mellan samma modeller eller en självrelation. Namn kan innehålla skiljetecken. Fältnamn och nyckelreferenser är skiftlägeskänsliga; lista varje nyckelfält en gång och inkludera varje medlem i en sammansatt nyckel.

Implicita relationella många-till-många-kanter kräver ett skalärt @id på fältnivå för varje deltagande modell. Sammansatta, blocknivå- eller unika identifierare skapar en diagnostik snarare än en missvisande virtuell relation. Använd en explicit kopplingsmodell för ytterligare fält, komplexa nycklar eller referentiella åtgärder.

Prisma / En-till-en-relation
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?
}
Partiella unika index visas som PUQ. Deras unikhet gäller endast matchande rader, så de kan inte etablera global identitet eller innebära en-till-en-kardinalitet.

Enums, sammansatta nycklar & databasmappningar

Använd @@id och @@unique för nycklar med flera kolumner, @map för fältnamn och @@map för tabellnamn. För en kompatibel leverantör med flera scheman, lista scheman i datakällan och tilldela modeller med @@schema. Modellnamnet förblir användbart i redigeraren medan den mappade identiteten bevaras för databasutdata.

PostgreSQL-exemplet nedan har en sammansatt primärnyckel och en klient-omfattande unik e-postadress. En explicit relation till denna nyckel måste tillhandahålla tenantId och accountId i samma ordning med kompatibla fälttyper.

Prisma / Mappat schema för sammansatt nyckel
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")
}

Leverantörer & återställningsbar diagnostik

Datakällor som stöds inkluderar PostgreSQL, MySQL, SQLite, SQL Server, MongoDB och CockroachDB. Konverteraren kontrollerar anslutningsspecifika identiteter, inbyggda typer, standardvärden, relationsregler och kollisioner i mappade namn.

Relationella leverantörer använder som standard relationMode = "foreignKeys". MongoDB använder relationMode = "prisma" och validerar dess _id-mappning och ObjectId-krav. Anta inte att ett relationellt exempel kan kopieras oförändrat till MongoDB.

Åtgärda saknade motsatta relationsfält, inkompatibla främmande nyckeltyper, ogiltiga nyckelmål och kombinationer av leverantörer som inte stöds med hjälp av diagnostiken. Ogiltiga-men-läsbara fält förblir synliga så att du kan reparera schemat på plats.

Leverantörer & återställningsbar diagnostik
LeverantörAnslutningsspecifik vägledning
PostgreSQL / CockroachDBSkalära listor och deklarationer för flera scheman stöds; inbyggda typer och standardvärden måste matcha den valda leverantören.
MySQLInga skalära listor eller alternativ för datakällsscheman. Validering av referentiella åtgärder följer det valda relationMode.
SQLiteInga Prisma-inbyggda @db-typsattribut, skalära listor eller alternativ för datakällsscheman.
SQL ServerInga enum-block, Json-fält eller skalära listor. Deklarationer för flera scheman stöds.
MongoDBAnvänd relationMode = "prisma", en _id-mappning och matchande ObjectId-skalär/inbyggda typer. Sammansatta typblock hör till denna koppling.

Utforska, exportera & spara

  1. Sök i utforskaren efter modell, fält, mappat namn, enum eller relation. Välj en relation för att granska dess fält, referenser, kardinalitet och referentiella åtgärder i Relationsinspektören; fokusera på valfri slutpunkt därifrån.
  2. Använd diagnostiska platser för att hoppa till källan som kräver uppmärksamhet. Justera layout- och visningsinställningar på ERD-byggaren.
  3. Exportera diagrammet som PNG, bildbaserad SVG eller PDF för ett dokument eller en presentation.
  4. Logga in för att spara en Prisma-fil med dess käll- och renderarkontext. Spara redigeringar innan du delar en skrivskyddad offentlig länk. En delad betraktare får inte åtkomst till källredigering.

Felsök ett Prisma-schema

Felsök ett Prisma-schema
SymptomVad som ska kontrolleras
En relation har en varningKontrollera det matchande motsatta fältet och relationsnamnet, kompatibla skalära/inbyggda typer, globalt unik refererad nyckel och fält/referenser endast på den ägande sidan.
En en-till-en-relation har en varningGör den ägande främmande nyckelgruppen globalt unik och den inversa relationen valfri. Om en ägande skalär är nullbar, gör även dess relation valfri.
En sammansatt nyckel visas inte som globalt unikKontrollera efter saknade, upprepade, valfria eller annorlunda skrivna fältnamn. Ett partiellt unikt predikat visas som PUQ istället för globalt UQ.
En implicit mång-till-många-kant saknasVarje modell behöver ett skalärt @id på fältnivå. Använd en explicit kopplingsmodell för sammansatta identifierare eller relationsattribut.
Diagrammet renderas med felLäsbarhetsfält behålls avsiktligt. Reparera diagnostik innan schemat betraktas som giltigt för dess databasleverantör.
Sparad layout återspeglar inte nya ändringarSpara aktuell källa och renderarkontext innan du delar eller laddar om; offentliga tittare ser den sparade versionen.
Källredigering är inaktiveradKontrollera dokumentägarskap, inloggning och om molninläsningen slutfördes. Återställningsbara inläsningsfel tillhandahåller Försök igen och Öppna filer.

Generera Prisma med rätt leverantör

Kopiera den här guiden som en AI-prompt, ange din Prisma-version och leverantör, och ange sedan dina modeller och affärsregler. Be assistenten att behålla befintliga @map- och @@map-namn medan schemat ändras.

Klistra in den returnerade Prisma-koden i redigeraren och granska diagnostiken innan du använder den någon annanstans. Ett renderat diagram ersätter inte leverantörsvalidering eller en migreringsgranskning.

AI request / Prisma AI-förfrågan
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.