Ir a la documentación

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.

schema.prisma → Diagrama ERAbrir Prisma a ERD

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

  1. Abra Prisma a ERD y elija una muestra o un documento vacío.
  2. 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.
  3. 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.
Prisma / Esquema de Prisma conectado
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 es parte del ejemplo de esquema. El visualizador no lo utiliza para establecer una conexión a la base de datos.

Modelos, campos y nombres mapeados

Modelos, campos y nombres mapeados
SintaxisSignificado
model User { ... }Un modelo con campos escalares y de relación.
String / Int / Boolean / DateTime / Decimal / Json / BytesTipos 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.
No mezcle tipos nativos y funciones predeterminadas de diferentes conectores. Los fragmentos solo de modelo son permisivos; una fuente de datos completa permite una validación de proveedor más estricta.

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.

Prisma / Relación uno a uno
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?
}
Los índices únicos parciales aparecen como PUQ. Su unicidad se aplica solo a las filas coincidentes, por lo que no pueden establecer una identidad global ni implicar una cardinalidad de uno a uno.

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.

Prisma / Esquema de clave compuesta 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")
}

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.

Proveedores y diagnósticos recuperables
ProveedorGuía específica del conector
PostgreSQL / CockroachDBSe admiten listas escalares y declaraciones de esquemas múltiples; los tipos nativos y los valores predeterminados deben coincidir con el proveedor seleccionado.
MySQLSin listas escalares ni opción de esquemas de origen de datos. La validación de acciones referenciales sigue el relationMode seleccionado.
SQLiteSin atributos de tipo @db nativos de Prisma, listas escalares ni opción de esquemas de origen de datos.
SQL ServerSin bloques enum, campos Json ni listas escalares. Se admiten declaraciones de varios esquemas.
MongoDBUse relationMode = "prisma", un mapeo _id y tipos escalares/nativos ObjectId coincidentes. Los bloques de tipo compuesto pertenecen a este conector.

Explorar, Exportar y Guardar

  1. 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í.
  2. 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.
  3. Exportar el diagrama como PNG, SVG con respaldo de imagen o PDF para un documento o presentación.
  4. 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

Solucionar problemas de un esquema de Prisma
SíntomaQué verificar
Una relación tiene una advertenciaCompruebe 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 advertenciaHaga 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 únicaCompruebe 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 erroresLos 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 edicionesGuarde 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á deshabilitadaCompruebe 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.

AI request / Solicitud de IA de 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.