Ir para a documentação

OS SEUS MODELOS, VISUALIZADOS

Prisma para ERD: guia

Visualize schema.prisma com modelos, relações e nomes mapeados. Entenda a sintaxe e corrija os diagnósticos.

schema.prisma → Diagrama ERAbrir Prisma para ERD

Veja a estrutura do seu esquema Prisma

Cole o schema.prisma no editor para visualizar modelos, campos escalares, chaves, enums, índices e relações. A conversão é executada no navegador e mantém modelos legíveis quando os diagnósticos precisam de atenção.

Esta ferramenta visualiza o seu esquema. Não se liga à sua fonte de dados, não executa o Prisma Client nem aplica migrações.

Os exemplos utilizam a sintaxe de fonte de dados do Prisma 6. No Prisma 7, mantenha o fornecedor em schema.prisma e configure o URL de ligação em prisma.config.ts. O Erd Go aceita uma fonte de dados apenas com fornecedor; cole o esquema aqui, e não o seu ficheiro de configuração ou credenciais.

Cole um esquema ligado

  1. Abra Prisma para ERD e escolha uma amostra ou um documento vazio.
  2. Cole o esquema abaixo, ou o seu próprio schema.prisma completo. O fornecedor da fonte de dados controla a validação específica do conector.
  3. Reveja o diagrama e os diagnósticos e, em seguida, inspecione os modelos, campos e relações no explorador. Utilize os controlos de esquema para organizar o diagrama.
Prisma / Esquema Prisma ligado
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 faz parte do exemplo de esquema. O visualizador não a utiliza para estabelecer uma ligação à base de dados.

Modelos, campos e nomes mapeados

Modelos, campos e nomes mapeados
SintaxeSignificado
model User { ... }Um modelo com campos escalares e de relação.
String / Int / Boolean / DateTime / Decimal / Json / BytesTipos de campo escalar; o suporte do conector ainda se aplica.
String? / Post[]Campo opcional / campo de lista.
@id / @@id([a, b])Chave primária de campo único / composta.
@unique / @@unique([a, b])Restrição de unicidade de campo único / composta.
@default(...) / @updatedAt / @db.VarChar(255)Predefinições, atualização de metadados e tipos nativos específicos do fornecedor.
@map("user_id") / @@map("users")Coluna mapeada / nome da tabela da base de dados.
enum Status { ... } / @@index([field])Valores de Enum / índices de modelo.
@@schema("public")Pertença de esquema para uma fonte de dados multiesquema compatível.
Não misture tipos nativos e funções predefinidas de diferentes conectores. Trechos apenas de modelo são permissivos; uma fonte de dados completa permite uma validação de fornecedor mais rigorosa.

Relações e regras de chaves

Uma relação explícita utiliza um campo de relação, campos de chave estrangeira escalares e @relation(fields: [...], references: [...]). Inclua um campo de relação oposto no outro modelo. Referencie uma chave primária ou uma chave globalmente única com tipos escalares e nativos compatíveis.

Se qualquer escalar de chave estrangeira for opcional, o seu campo de relação proprietário também deve ser opcional. Uma relação opcional pode ter escalares obrigatórios. Um proprietário um-para-um precisa de @unique ou @@unique nos seus campos de chave estrangeira, e o campo inverso sem esses escalares deve ser opcional.

Utilize o mesmo nome de relação entre aspas em ambos os lados para distinguir múltiplas ligações entre os mesmos modelos ou uma autorrelação. Os nomes podem conter pontuação. Os nomes de campos e referências de chave diferenciam maiúsculas de minúsculas; liste cada campo de chave uma vez e inclua todos os membros de chaves compostas.

As arestas relacionais muitos-para-muitos implícitas requerem um campo escalar @id ao nível do campo em cada modelo participante. Identificadores compostos, ao nível do bloco ou apenas únicos produzem um diagnóstico em vez de uma relação virtual enganadora. Utilize um modelo de junção explícito para campos adicionais, chaves complexas ou ações referenciais.

Prisma / Relação um-para-um
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?
}
Os índices únicos parciais aparecem como PUQ. A sua unicidade aplica-se apenas às linhas correspondentes, pelo que não podem estabelecer uma identidade global nem implicar uma cardinalidade um-para-um.

Enums, chaves compostas e mapeamentos de base de dados

Utilize @@id e @@unique para chaves de várias colunas, @map para nomes de campos e @@map para nomes de tabelas. Para um fornecedor multi-esquema compatível, liste os esquemas na origem de dados e atribua modelos com @@schema. O nome do modelo permanece útil no editor enquanto a identidade mapeada é preservada para a saída da base de dados.

O exemplo de PostgreSQL abaixo tem uma chave primária composta e um e-mail único com âmbito de inquilino. Uma relação explícita com esta chave deve fornecer tenantId e accountId na mesma ordem com tipos de campo compatíveis.

Prisma / Esquema de chave composta mapeada
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")
}

Fornecedores e diagnósticos recuperáveis

Os fornecedores de fontes de dados suportados incluem PostgreSQL, MySQL, SQLite, SQL Server, MongoDB e CockroachDB. O conversor verifica identidades específicas do conector, tipos nativos, predefinições, regras de relação e colisões de nomes mapeados.

Os fornecedores relacionais utilizam por predefinição relationMode = "foreignKeys". O MongoDB utiliza relationMode = "prisma" e valida o seu mapeamento de _id e os requisitos de ObjectId. Não assuma que um exemplo relacional pode ser copiado sem alterações para o MongoDB.

Corrija campos de relação oposta em falta, tipos de chave estrangeira incompatíveis, alvos de chave inválidos e combinações de fornecedores não suportadas usando os diagnósticos. Campos inválidos mas legíveis permanecem visíveis para que possa reparar o esquema no local.

Fornecedores e diagnósticos recuperáveis
FornecedorOrientação específica do conector
PostgreSQL / CockroachDBListas escalares e declarações de múltiplos esquemas são suportadas; os tipos nativos e predefinições devem corresponder ao fornecedor selecionado.
MySQLSem listas escalares ou opção de esquemas de fonte de dados. A validação da ação referencial segue o relationMode selecionado.
SQLiteSem atributos de tipo @db nativos do Prisma, listas escalares ou opção de esquemas de fonte de dados.
SQL ServerSem blocos enum, campos Json ou listas escalares. Declarações de múltiplos esquemas são suportadas.
MongoDBUtilize relationMode = "prisma", um mapeamento _id e tipos escalares/nativos ObjectId correspondentes. Os blocos de tipos compostos pertencem a este conector.

Explorar, exportar e salvar

  1. Pesquise no explorador por modelo, campo, nome mapeado, enum ou relação. Selecione uma relação para rever os seus campos, referências, cardinalidade e ações referenciais no Relation Inspector; foque qualquer uma das extremidades a partir daí.
  2. Utilize as localizações de diagnóstico para ir diretamente para a origem que requer atenção. Ajuste o esquema e as preferências de visualização no ERD.
  3. Exporte o diagrama como PNG, SVG baseado em imagem ou PDF para um documento ou apresentação.
  4. Inicie sessão para Salvar um ficheiro Prisma com o seu contexto de origem e renderizador. Salve as edições antes de partilhar uma ligação pública de apenas leitura. Um visualizador partilhado não recebe acesso de edição de origem.

Resolver problemas num esquema Prisma

Resolver problemas num esquema Prisma
SintomaO que verificar
Uma relação tem um avisoVerifique o campo oposto correspondente e o nome da relação, tipos escalares/nativos compatíveis, chave referenciada globalmente única e campos/referências apenas no lado proprietário.
Uma relação um-para-um tem um avisoTorne o grupo de chaves estrangeiras proprietário globalmente único e a relação inversa opcional. Se um escalar proprietário for anulável, torne a sua relação opcional também.
Uma chave composta não é mostrada como globalmente únicaVerifique se existem nomes de campos em falta, repetidos, opcionais ou com capitalização diferente. Um predicado único parcial é mostrado como PUQ em vez de UQ global.
Uma aresta muitos-para-muitos implícita está ausenteCada modelo precisa de um @id escalar ao nível do campo. Utilize um modelo de junção explícito para identificadores compostos ou atributos de relação.
O diagrama é renderizado com errosOs campos legíveis são deliberadamente retidos. Repare os diagnósticos antes de tratar o esquema como válido para o seu fornecedor de base de dados.
O esquema salvo não reflete novas ediçõesSalvar a origem atual e o contexto do renderizador antes de partilhar ou recarregar; os visualizadores públicos veem a versão salva.
A edição da origem está desativadaVerifique a propriedade do documento, o início de sessão e se o carregamento na nuvem terminou. Erros de carregamento recuperáveis fornecem Tentar novamente e Abrir ficheiros.

Gerar Prisma com o fornecedor correto

Copie este guia como um prompt de IA, nomeie a sua versão e fornecedor do Prisma e, em seguida, indique os seus modelos e regras de negócio. Peça ao assistente para preservar os nomes @map e @@map existentes enquanto altera o esquema.

Cole o Prisma devolvido no editor e reveja os diagnósticos antes de o utilizar noutro local. Um diagrama renderizado não substitui a validação do fornecedor nem uma revisão de migração.

AI request / Pedido de IA do Prisma
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.