UW MODELLEN, GEVISUALISEERD
Prisma naar ERD: handleiding
Visualiseer schema.prisma met modellen, relaties en toegewezen namen. Begrijp de syntaxis en los meldingen op.
Zie de structuur van uw Prisma-schema
Plak schema.prisma in de editor om modellen, scalaire velden, sleutels, enums, indexen en relaties te visualiseren. Conversie wordt in de browser uitgevoerd en behoudt leesbare modellen wanneer diagnostiek aandacht vereist.
Dit hulpprogramma visualiseert uw schema. Het maakt geen verbinding met uw gegevensbron, voert Prisma Client uit of past migraties toe.
De voorbeelden gebruiken Prisma 6 datasource syntaxis. In Prisma 7, houd de provider in schema.prisma en configureer de verbindings-URL in prisma.config.ts. Erd Go accepteert een provider-only datasource; plak hier het schema, niet uw configuratiebestand of referenties.
Plak een verbonden schema
- Open Prisma naar ERD en kies een voorbeeld of een leeg document.
- Plak het onderstaande schema of je eigen volledige schema.prisma. De datasource-provider beheert connectorgespecifieke validatie.
- Bekijk het diagram en de diagnostiek, inspecteer vervolgens modellen, velden en relaties in de explorer. Gebruik lay-outcontroles om het diagram te rangschikken.
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])
}Modellen, velden & gekoppelde namen
| Syntaxis | Betekenis |
|---|---|
| model Gebruiker { ... } | Een model met scalaire en relatievelden. |
| Tekst / Int / Boolean / DateTime / Decimaal / Json / Bytes | Scalaire veldtypen; connectorondersteuning is nog steeds van toepassing. |
| Tekst? / Post[] | Optioneel veld / lijstveld. |
| @id / @@id([a, b]) | Sleutel met één veld / samengestelde primaire sleutel. |
| @unique / @@unique([a, b]) | Unieke beperking met één veld / samengestelde unieke beperking. |
| @default(...) / @updatedAt / @db.VarChar(255) | Standaardwaarden, updatemetagegevens en providerspecifieke natieve typen. |
| @map("user_id") / @@map("users") | Gemapte kolom / databasetabelnaam. |
| enum Status { ... } / @@index([field]) | Enum-waarden / modelindexen. |
| @@schema("public") | Schema-lidmaatschap voor een compatibele multi-schema gegevensbron. |
Relaties & sleutelregels
Een expliciete relatie gebruikt een relatieveld, scalaire vreemde-sleutelvelden en @relation(fields: [...], references: [...]). Voeg een tegengesteld relatieveld toe op het andere model. Verwijs naar een primaire sleutel of mondiaal unieke sleutel met compatibele scalaire en native typen.
Als een scalaire vreemde sleutel optioneel is, moet het bijbehorende relatieveld ook optioneel zijn. Een optionele relatie kan verplichte scalaire waarden hebben. Een een-op-een-eigenaar heeft @unique of @@unique nodig op zijn vreemde-sleutelvelden, en het omgekeerde veld zonder die scalaire waarden moet optioneel zijn.
Gebruik dezelfde geciteerde relatienaam aan beide zijden om meerdere koppelingen tussen dezelfde modellen of een zelfrelatie te onderscheiden. Namen mogen leestekens bevatten. Veldnamen en sleutelverwijzingen zijn hoofdlettergevoelig; geef elke sleutelveld één keer op en neem elk samengesteld sleutellid op.
Impliciete relationele many-to-many-randen vereisen één scalair veldniveau @id op elk deelnemend model. Samengestelde, blokniveau- of unieke-only-identificatoren produceren een diagnose in plaats van een misleidende virtuele relatie. Gebruik een expliciet koppelmodel voor extra velden, complexe sleutels of referentiële acties.
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, samengestelde sleutels & databasetoewijzingen
Gebruik @@id en @@unique voor sleutels met meerdere kolommen, @map voor veldnamen en @@map voor tabelnamen. Voor een compatibele multi-schema provider, vermeld schema's in de datasource en wijs modellen toe met @@schema. De modelnaam blijft nuttig in de editor terwijl de toegewezen identiteit behouden blijft voor database-uitvoer.
Het PostgreSQL-voorbeeld hieronder heeft een samengestelde primaire sleutel en een tenant-scoped uniek e-mailadres. Een expliciete relatie tot deze sleutel moet tenantId en accountId in dezelfde volgorde leveren met compatibele veldtypen.
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")
}Providers en herstelbare diagnoses
Ondersteunde datasource providers omvatten PostgreSQL, MySQL, SQLite, SQL Server, MongoDB en CockroachDB. De converter controleert connector-specifieke identiteiten, native typen, standaardwaarden, relatieregels en botsingen van toegewezen namen.
Relationele providers gebruiken standaard relationMode = "foreignKeys". MongoDB gebruikt relationMode = "prisma" en valideert de _id-mapping en ObjectId-vereisten. Ga er niet van uit dat een relationeel voorbeeld ongewijzigd naar MongoDB kan worden gekopieerd.
Los ontbrekende velden voor tegenovergestelde relaties, onverenigbare vreemde-sleutel-typen, ongeldige sleuteldoelen en niet-ondersteunde providercombinaties op met behulp van de diagnostiek. Ongeldige-maar-leesbare velden blijven zichtbaar zodat je het schema direct kunt herstellen.
| Provider | Connector-specifieke begeleiding |
|---|---|
| PostgreSQL / CockroachDB | Scalaire lijsten en multi-schemaverklaringen worden ondersteund; native typen en standaardwaarden moeten overeenkomen met de geselecteerde provider. |
| MySQL | Geen scalaire lijsten of datasource schema's optie. Validatie van referentiële acties volgt de geselecteerde relationMode. |
| SQLite | Geen Prisma native @db type-attributen, scalaire lijsten of datasource schema's optie. |
| SQL Server | Geen enum-blokken, Json-velden of scalaire lijsten. Multi-schema declaraties worden ondersteund. |
| MongoDB | Gebruik relationMode = "prisma", een _id-mapping en bijpassende ObjectId-scalar/native types. Samengestelde typeblokken behoren tot deze connector. |
Verkennen, exporteren en opslaan
- Doorzoek de explorer op model, veld, gemaptte naam, enum of relatie. Selecteer een relatie om de velden, verwijzingen, cardinaliteit en referentiële acties te bekijken in de Relatie-inspecteur; focus vanaf daar op een van de eindpunten.
- Gebruik diagnostische locaties om naar de bron te springen die aandacht vereist. Pas de lay-out en weergavevoorkeuren aan op de ERD.
- Exporteer het diagram als PNG, SVG met afbeelding of PDF voor een document of presentatie.
- Meld u aan om een Prisma-bestand op te slaan met de bron- en renderercontext. Sla bewerkingen op voordat u een alleen-lezen openbare koppeling deelt. Een gedeelde kijker ontvangt geen bewerkingsrechten voor de bron.
Problemen oplossen met een Prisma-schema
| Symptoom | Wat te controleren |
|---|---|
| Een relatie heeft een waarschuwing | Controleer het bijbehorende tegenoverliggende veld en de relatienaam, compatibele scalaire/natieve typen, wereldwijd unieke gerefereerde sleutel en velden/referenties aan alleen de eigenzijde. |
| Een een-op-eenrelatie heeft een waarschuwing | Maak de eigengerechtigde vreemde-sleutelgroep globaal uniek en de inverse relatie optioneel. Als een eigengerechtigde scalaire waarde nullable is, maak de relatie dan ook optioneel. |
| Een samengestelde sleutel wordt niet weergegeven als globaal uniek | Controleer op ontbrekende, herhaalde, optionele of anders genoteerde veldnamen. Een gedeeltelijk uniek predikaat wordt weergegeven als PUQ in plaats van globaal UQ. |
| Een impliciete veel-op-veel-rand ontbreekt | Elk model heeft één scalaire @id op veldniveau nodig. Gebruik een expliciet koppelmodel voor samengestelde identificatoren of relatie-attributen. |
| Het diagram rendert met fouten | Leesbare velden worden bewust behouden. Herstel diagnoses voordat u het schema als geldig beschouwt voor de databaseprovider. |
| Opgeslagen lay-out weerspiegelt geen nieuwe bewerkingen | Sla de huidige bron- en renderercontext op voordat u deelt of herlaadt; openbare kijkers zien de opgeslagen versie. |
| Bronbewerking is uitgeschakeld | Controleer documenteigendom, aanmelding en of het laden in de cloud is voltooid. Herstelbare laadfouten bieden de opties Opnieuw proberen en Bestanden openen. |
Genereer Prisma met de juiste provider
Kopieer deze gids als een AI-prompt, noem uw Prisma-versie en provider, en vermeld vervolgens uw modellen en bedrijfsregels. Vraag de assistent om bestaande @map- en @@map-namen te behouden terwijl het schema wordt gewijzigd.
Plak de geretourneerde Prisma in de editor en controleer de diagnostiek voordat je deze erg anders gebruikt. Een gerenderd diagram vervangt geen providervalidatie of migratiebeoordeling.
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.