Naar documentatie springen

UW MODELLEN, GEVISUALISEERD

Prisma naar ERD: handleiding

Visualiseer schema.prisma met modellen, relaties en toegewezen namen. Begrijp de syntaxis en los meldingen op.

schema.prisma → ER-diagramPrisma naar ERD openen

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

  1. Open Prisma naar ERD en kies een voorbeeld of een leeg document.
  2. Plak het onderstaande schema of je eigen volledige schema.prisma. De datasource-provider beheert connectorgespecifieke validatie.
  3. Bekijk het diagram en de diagnostiek, inspecteer vervolgens modellen, velden en relaties in de explorer. Gebruik lay-outcontroles om het diagram te rangschikken.
Prisma / Verbonden 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 maakt deel uit van het schemavoorbeeld. De visualizer gebruikt dit niet om een databaseverbinding tot stand te brengen.

Modellen, velden & gekoppelde namen

Modellen, velden & gekoppelde namen
SyntaxisBetekenis
model Gebruiker { ... }Een model met scalaire en relatievelden.
Tekst / Int / Boolean / DateTime / Decimaal / Json / BytesScalaire 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.
Meng geen native typen en standaardfuncties van verschillende connectoren. Snippets met alleen een model zijn toegankelijk; een complete gegevensbron maakt striktere validatie door de provider mogelijk.

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.

Prisma / Eén-op-één relatie
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?
}
Gedeeltelijke unieke indexen verschijnen als PUQ. Hun uniekheid is alleen van toepassing op overeenkomende rijen, dus ze kunnen geen globale identiteit vaststellen of een één-op-één-kardinaliteit impliceren.

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.

Prisma / Gemaakt samengesteld-sleutelschema
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.

Providers en herstelbare diagnoses
ProviderConnector-specifieke begeleiding
PostgreSQL / CockroachDBScalaire lijsten en multi-schemaverklaringen worden ondersteund; native typen en standaardwaarden moeten overeenkomen met de geselecteerde provider.
MySQLGeen scalaire lijsten of datasource schema's optie. Validatie van referentiële acties volgt de geselecteerde relationMode.
SQLiteGeen Prisma native @db type-attributen, scalaire lijsten of datasource schema's optie.
SQL ServerGeen enum-blokken, Json-velden of scalaire lijsten. Multi-schema declaraties worden ondersteund.
MongoDBGebruik relationMode = "prisma", een _id-mapping en bijpassende ObjectId-scalar/native types. Samengestelde typeblokken behoren tot deze connector.

Verkennen, exporteren en opslaan

  1. 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.
  2. Gebruik diagnostische locaties om naar de bron te springen die aandacht vereist. Pas de lay-out en weergavevoorkeuren aan op de ERD.
  3. Exporteer het diagram als PNG, SVG met afbeelding of PDF voor een document of presentatie.
  4. 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

Problemen oplossen met een Prisma-schema
SymptoomWat te controleren
Een relatie heeft een waarschuwingControleer 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 waarschuwingMaak 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 uniekControleer 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 ontbreektElk model heeft één scalaire @id op veldniveau nodig. Gebruik een expliciet koppelmodel voor samengestelde identificatoren of relatie-attributen.
Het diagram rendert met foutenLeesbare velden worden bewust behouden. Herstel diagnoses voordat u het schema als geldig beschouwt voor de databaseprovider.
Opgeslagen lay-out weerspiegelt geen nieuwe bewerkingenSla de huidige bron- en renderercontext op voordat u deelt of herlaadt; openbare kijkers zien de opgeslagen versie.
Bronbewerking is uitgeschakeldControleer 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.

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