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.
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
- Öppna Prisma till ERD och välj ett exempel eller ett tomt dokument.
- Klistra in schemat nedan, eller ditt eget fullständiga schema.prisma. Datakällans leverantör styr anslutningsspecifik validering.
- Granska diagrammet och diagnostiken, inspektera sedan modeller, fält och relationer i utforskaren. Använd layoutkontroller för att ordna diagrammet.
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])
}Modeller, fält & mappade namn
| Syntax | Betydelse |
|---|---|
| model User { ... } | En modell med skalära fält och relationsfält. |
| String / Int / Boolean / DateTime / Decimal / Json / Bytes | Skalä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. |
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.
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?
}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.
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ör | Anslutningsspecifik vägledning |
|---|---|
| PostgreSQL / CockroachDB | Skalära listor och deklarationer för flera scheman stöds; inbyggda typer och standardvärden måste matcha den valda leverantören. |
| MySQL | Inga skalära listor eller alternativ för datakällsscheman. Validering av referentiella åtgärder följer det valda relationMode. |
| SQLite | Inga Prisma-inbyggda @db-typsattribut, skalära listor eller alternativ för datakällsscheman. |
| SQL Server | Inga enum-block, Json-fält eller skalära listor. Deklarationer för flera scheman stöds. |
| MongoDB | Använd relationMode = "prisma", en _id-mappning och matchande ObjectId-skalär/inbyggda typer. Sammansatta typblock hör till denna koppling. |
Utforska, exportera & spara
- 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.
- Använd diagnostiska platser för att hoppa till källan som kräver uppmärksamhet. Justera layout- och visningsinställningar på ERD-byggaren.
- Exportera diagrammet som PNG, bildbaserad SVG eller PDF för ett dokument eller en presentation.
- 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
| Symptom | Vad som ska kontrolleras |
|---|---|
| En relation har en varning | Kontrollera 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 varning | Gö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 unik | Kontrollera 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 saknas | Varje modell behöver ett skalärt @id på fältnivå. Använd en explicit kopplingsmodell för sammansatta identifierare eller relationsattribut. |
| Diagrammet renderas med fel | Läsbarhetsfält behålls avsiktligt. Reparera diagnostik innan schemat betraktas som giltigt för dess databasleverantör. |
| Sparad layout återspeglar inte nya ändringar | Spara aktuell källa och renderarkontext innan du delar eller laddar om; offentliga tittare ser den sparade versionen. |
| Källredigering är inaktiverad | Kontrollera 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.
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.