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.
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
- Abra Prisma para ERD e escolha uma amostra ou um documento vazio.
- 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.
- 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.
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])
}Modelos, campos e nomes mapeados
| Sintaxe | Significado |
|---|---|
| model User { ... } | Um modelo com campos escalares e de relação. |
| String / Int / Boolean / DateTime / Decimal / Json / Bytes | Tipos 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. |
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.
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, 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.
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.
| Fornecedor | Orientação específica do conector |
|---|---|
| PostgreSQL / CockroachDB | Listas escalares e declarações de múltiplos esquemas são suportadas; os tipos nativos e predefinições devem corresponder ao fornecedor selecionado. |
| MySQL | Sem listas escalares ou opção de esquemas de fonte de dados. A validação da ação referencial segue o relationMode selecionado. |
| SQLite | Sem atributos de tipo @db nativos do Prisma, listas escalares ou opção de esquemas de fonte de dados. |
| SQL Server | Sem blocos enum, campos Json ou listas escalares. Declarações de múltiplos esquemas são suportadas. |
| MongoDB | Utilize relationMode = "prisma", um mapeamento _id e tipos escalares/nativos ObjectId correspondentes. Os blocos de tipos compostos pertencem a este conector. |
Explorar, exportar e salvar
- 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í.
- 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.
- Exporte o diagrama como PNG, SVG baseado em imagem ou PDF para um documento ou apresentação.
- 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
| Sintoma | O que verificar |
|---|---|
| Uma relação tem um aviso | Verifique 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 aviso | Torne 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 única | Verifique 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á ausente | Cada 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 erros | Os 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ções | Salvar 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á desativada | Verifique 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.
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.