SUS MODELOS, VISUALIZADOS
Prisma a ERD: guía
Visualiza schema.prisma con modelos, relaciones y nombres mapeados. Comprende la sintaxis y corrige los diagnósticos.
Vea la estructura de su esquema de Prisma
Pegue schema.prisma en el editor para visualizar modelos, campos escalares, claves, enums, índices y relaciones. La conversión se ejecuta en el navegador y conserva modelos legibles cuando los diagnósticos necesitan atención.
Esta herramienta visualiza su esquema. No se conecta a su fuente de datos, no ejecuta Prisma Client ni aplica migraciones.
Los ejemplos utilizan la sintaxis de fuente de datos de Prisma 6. En Prisma 7, mantenga el proveedor en schema.prisma y configure la URL de conexión en prisma.config.ts. Erd Go acepta una fuente de datos solo con el proveedor; pegue el esquema aquí, no su archivo de configuración ni sus credenciales.
Pegue un esquema conectado
- Abra Prisma a ERD y elija una muestra o un documento vacío.
- Pegue el esquema a continuación, o su propio schema.prisma completo. El proveedor de la fuente de datos controla la validación específica del conector.
- Revise el diagrama y los diagnósticos, luego inspeccione los modelos, campos y relaciones en el explorador. Use los controles de diseño para organizar el 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 y nombres mapeados
| Sintaxis | Significado |
|---|---|
| model User { ... } | Un modelo con campos escalares y de relación. |
| String / Int / Boolean / DateTime / Decimal / Json / Bytes | Tipos de campos escalares; el soporte del conector aún se aplica. |
| String? / Post[] | Campo opcional / campo de lista. |
| @id / @@id([a, b]) | Clave primaria de un solo campo / compuesta. |
| @unique / @@unique([a, b]) | Restricción única de un solo campo / compuesta. |
| @default(...) / @updatedAt / @db.VarChar(255) | Valores por defecto, actualización de metadatos y tipos nativos específicos del proveedor. |
| @map("user_id") / @@map("users") | Columna mapeada / nombre de la tabla de la base de datos. |
| enum Status { ... } / @@index([field]) | Valores de Enum / índices de modelo. |
| @@schema("public") | Pertenencia a esquema para una fuente de datos multiesquema compatible. |
Relaciones y reglas de claves
Una relación explícita utiliza un campo de relación, campos de clave foránea escalares y @relation(fields: [...], references: [...]). Incluya un campo de relación opuesto en el otro modelo. Haga referencia a una clave primaria o una clave globalmente única con tipos escalares y nativos compatibles.
Si cualquier escalar de clave foránea es opcional, su campo de relación propietario también debe ser opcional. Una relación opcional puede tener escalares requeridos. Un propietario uno a uno necesita @unique o @@unique en sus campos de clave foránea, y el campo inverso sin esos escalares debe ser opcional.
Utilice el mismo nombre de relación entrecomillado en ambos lados para distinguir múltiples enlaces entre los mismos modelos o una autorrelación. Los nombres pueden contener puntuación. Los nombres de campo y las referencias de clave distinguen entre mayúsculas y minúsculas; enumere cada campo de clave una vez e incluya cada miembro de clave compuesta.
Los bordes relacionales implícitos de muchos a muchos requieren un @id escalar a nivel de campo en cada modelo participante. Los identificadores compuestos, a nivel de bloque o solo únicos producen un diagnóstico en lugar de una relación virtual engañosa. Use un modelo de unión explícito para campos adicionales, claves complejas o acciones referenciales.
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, claves compuestas y mapeos de base de datos
Utilice @@id y @@unique para claves de varias columnas, @map para nombres de campos y @@map para nombres de tablas. Para un proveedor de esquemas múltiples compatible, enumere los esquemas en el origen de datos y asigne modelos con @@schema. El nombre del modelo sigue siendo útil en el editor mientras que la identidad asignada se conserva para la salida de la base de datos.
El ejemplo de PostgreSQL a continuación tiene una clave primaria compuesta y un correo electrónico único con ámbito de inquilino. Una relación explícita con esta clave debe proporcionar tenantId y accountId en el mismo orden con tipos de campo compatibles.
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")
}Proveedores y diagnósticos recuperables
Los proveedores de origen de datos admitidos incluyen PostgreSQL, MySQL, SQLite, SQL Server, MongoDB y CockroachDB. El convertidor verifica identidades específicas del conector, tipos nativos, valores predeterminados, reglas de relación y colisiones de nombres asignados.
Los proveedores relacionales utilizan por defecto relationMode = "foreignKeys". MongoDB utiliza relationMode = "prisma" y valida su mapeo de _id y los requisitos de ObjectId. No asuma que un ejemplo relacional se puede copiar sin cambios a MongoDB.
Corrija los campos de relación opuestos faltantes, tipos de clave externa incompatibles, destinos de clave no válidos y combinaciones de proveedores no admitidas utilizando los diagnósticos. Los campos no válidos pero legibles permanecen visibles para que pueda reparar el esquema en el lugar.
| Proveedor | Guía específica del conector |
|---|---|
| PostgreSQL / CockroachDB | Se admiten listas escalares y declaraciones de esquemas múltiples; los tipos nativos y los valores predeterminados deben coincidir con el proveedor seleccionado. |
| MySQL | Sin listas escalares ni opción de esquemas de origen de datos. La validación de acciones referenciales sigue el relationMode seleccionado. |
| SQLite | Sin atributos de tipo @db nativos de Prisma, listas escalares ni opción de esquemas de origen de datos. |
| SQL Server | Sin bloques enum, campos Json ni listas escalares. Se admiten declaraciones de varios esquemas. |
| MongoDB | Use relationMode = "prisma", un mapeo _id y tipos escalares/nativos ObjectId coincidentes. Los bloques de tipo compuesto pertenecen a este conector. |
Explorar, Exportar y Guardar
- Busque en el explorador por modelo, campo, nombre mapeado, enum o relación. Seleccione una relación para revisar sus campos, referencias, cardinalidad y acciones referenciales en el Inspector de relaciones; enfoque cualquiera de los extremos desde allí.
- Use ubicaciones de diagnóstico para saltar a la fuente que requiere atención. Ajuste el diseño y las preferencias de visualización en el ERD.
- Exportar el diagrama como PNG, SVG con respaldo de imagen o PDF para un documento o presentación.
- Inicia sesión para guardar un archivo de Prisma con su fuente y contexto de renderizado. Guarda los cambios antes de compartir un enlace público de solo lectura. Un visor compartido no recibe acceso de edición a la fuente.
Solucionar problemas de un esquema de Prisma
| Síntoma | Qué verificar |
|---|---|
| Una relación tiene una advertencia | Compruebe el campo opuesto coincidente y el nombre de la relación, los tipos escalares/nativos compatibles, la clave referenciada globalmente única y los campos/referencias solo en el lado propietario. |
| Una relación uno a uno tiene una advertencia | Haga que el grupo de clave foránea propietario sea globalmente único y la relación inversa opcional. Si un escalar propietario permite nulos, haga que su relación también sea opcional. |
| Una clave compuesta no se muestra como globalmente única | Compruebe si faltan nombres de campo, si están repetidos, si son opcionales o si tienen un uso distinto de mayúsculas y minúsculas. Un predicado único parcial se muestra como PUQ en lugar de UQ global. |
| Falta un borde implícito de muchos a muchos. | Cada modelo necesita un @id escalar a nivel de campo. Use un modelo de unión explícito para identificadores compuestos o atributos de relación. |
| El diagrama se renderiza con errores | Los campos legibles se conservan deliberadamente. Repare los diagnósticos antes de tratar el esquema como válido para su proveedor de base de datos. |
| El diseño guardado no refleja las nuevas ediciones | Guarde el contexto actual de la fuente y del renderizador antes de compartir o recargar; los visores públicos ven la versión guardada. |
| La edición de fuente está deshabilitada | Compruebe la propiedad del documento, el inicio de sesión y si finalizó la carga en la nube. Los errores de carga recuperables ofrecen Reintentar y Abrir archivos. |
Generar Prisma con el proveedor adecuado
Copie esta guía como un prompt de IA, nombre su versión y proveedor de Prisma, luego indique sus modelos y reglas de negocio. Pida al asistente que preserve los nombres @map y @@map existentes mientras cambia el esquema.
Pegue el Prisma devuelto en el editor y revise los diagnósticos antes de usarlo en otro lugar. Un diagrama renderizado no reemplaza la validación del proveedor ni una revisión de migración.
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.