Lewati ke dokumentasi

MODEL ANDA, DIVISUALISASIKAN

Panduan Prisma ke ERD

Visualisasikan schema.prisma dengan model, relasi, dan nama yang dipetakan. Pahami sintaks dan perbaiki diagnostik.

schema.prisma → Diagram ERBuka Prisma ke ERD

Lihat struktur skema Prisma Anda

Tempel schema.prisma ke dalam editor untuk memvisualisasikan model, bidang skalar, kunci, enum, indeks, dan relasi. Konversi berjalan di peramban dan mempertahankan model yang dapat dibaca saat diagnostik memerlukan perhatian.

Alat ini memvisualisasikan skema Anda. Alat ini tidak terhubung ke sumber data Anda, menjalankan Prisma Client, atau menerapkan migrasi.

Contoh-contoh tersebut menggunakan sintaksis sumber data Prisma 6. Di Prisma 7, simpan penyedia di schema.prisma dan konfigurasikan URL koneksi di prisma.config.ts. Erd Go menerima sumber data khusus penyedia; tempel skema di sini, bukan file konfigurasi atau kredensial Anda.

Tempel skema yang terhubung

  1. Buka Prisma ke ERD dan pilih sampel atau dokumen kosong.
  2. Tempel skema di bawah ini, atau schema.prisma lengkap Anda sendiri. Penyedia sumber data mengontrol validasi khusus konektor.
  3. Tinjau diagram dan diagnostik, lalu periksa model, kolom, dan relasi di penjelajah. Gunakan kontrol tata letak untuk mengatur diagram.
Prisma / Skema Prisma yang terhubung
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 adalah bagian dari contoh skema. Visualizer tidak menggunakannya untuk membuat koneksi database.

Model, bidang & nama yang dipetakan

Model, bidang & nama yang dipetakan
SintaksisArti
model User { ... }Model dengan bidang skalar dan relasi.
String / Int / Boolean / DateTime / Decimal / Json / BytesTipe kolom skalar; dukungan konektor tetap berlaku.
String? / Post[]Bidang opsional / bidang daftar.
@id / @@id([a, b])Kunci primer kolom tunggal / komposit.
@unique / @@unique([a, b])Batasan unik kolom tunggal / komposit.
@default(...) / @updatedAt / @db.VarChar(255)Default, perbarui metadata, dan tipe asli khusus penyedia.
@map("user_id") / @@map("users")Nama kolom / tabel basis data yang dipetakan.
enum Status { ... } / @@index([field])Nilai Enum / indeks model.
@@schema("public")Keanggotaan skema untuk sumber data multi-skema yang kompatibel.
Jangan mencampur tipe asli dan fungsi default dari konektor yang berbeda. Cuplikan yang hanya model bersifat permisif; sumber data yang lengkap memungkinkan validasi penyedia yang lebih ketat.

Relasi & aturan kunci

Relasi eksplisit menggunakan bidang relasi, bidang kunci asing skalar, dan @relation(fields: [...], references: [...]). Sertakan bidang relasi yang berlawanan pada model lainnya. Referensikan kunci primer atau kunci unik global dengan tipe skalar dan bawaan yang kompatibel.

Jika skalar kunci asing bersifat opsional, bidang relasi pemiliknya juga harus opsional. Relasi opsional dapat memiliki skalar wajib. Pemilik one-to-one memerlukan @unique atau @@unique pada bidang kunci asingnya, dan bidang invers tanpa skalar tersebut harus bersifat opsional.

Gunakan nama relasi bertanda kutip yang sama di kedua sisi untuk membedakan beberapa tautan antara model yang sama atau relasi mandiri. Nama boleh berisi tanda baca. Nama bidang dan referensi kunci bersifat peka huruf besar-kecil; daftarkan setiap bidang kunci sekali dan sertakan setiap anggota kunci gabungan.

Relasi many-to-many implisit memerlukan satu @id tingkat bidang skalar pada setiap model yang berpartisipasi. Pengidentifikasi komposit, tingkat blok, atau unik-saja akan menghasilkan diagnostik alih-alih hubungan virtual yang menyesatkan. Gunakan model gabungan eksplisit untuk bidang tambahan, kunci kompleks, atau tindakan referensial.

Prisma / Relasi satu-ke-satu
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?
}
Indeks unik parsial muncul sebagai PUQ. Keunikannya hanya berlaku untuk baris yang cocok, sehingga tidak dapat menetapkan identitas global atau menyiratkan kardinalitas satu-ke-satu.

Enum, kunci komposit & pemetaan basis data

Gunakan @@id dan @@unique untuk kunci multi-kolom, @map untuk nama kolom, dan @@map untuk nama tabel. Untuk penyedia multi-skema yang kompatibel, cantumkan skema dalam sumber data dan tetapkan model dengan @@schema. Nama model tetap berguna di editor sementara identitas yang dipetakan dipertahankan untuk keluaran database.

Contoh PostgreSQL di bawah ini memiliki kunci utama komposit dan email unik yang dicakup oleh penyewa (tenant). Relasi eksplisit ke kunci ini harus menyertakan tenantId dan accountId dalam urutan yang sama dengan tipe bidang yang kompatibel.

Prisma / Skema kunci komposit yang dipetakan
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")
}

Penyedia & diagnostik yang dapat dipulihkan

Penyedia sumber data yang didukung termasuk PostgreSQL, MySQL, SQLite, SQL Server, MongoDB, dan CockroachDB. Konverter memeriksa identitas khusus konektor, tipe asli, default, aturan relasi, dan tabrakan nama yang dipetakan.

Penyedia relasional secara default menggunakan relationMode = "foreignKeys". MongoDB menggunakan relationMode = "prisma" dan memvalidasi pemetaan _id serta persyaratan ObjectId-nya. Jangan berasumsi bahwa contoh relasional dapat disalin tanpa perubahan ke MongoDB.

Perbaiki kolom relasi berlawanan yang hilang, tipe kunci asing yang tidak kompatibel, target kunci yang tidak valid, dan kombinasi penyedia yang tidak didukung menggunakan diagnostik. Kolom yang tidak valid namun dapat dibaca tetap terlihat sehingga Anda dapat memperbaiki skema di tempat.

Penyedia & diagnostik yang dapat dipulihkan
PenyediaPanduan spesifik konektor
PostgreSQL / CockroachDBDaftar skalar dan deklarasi multi-skema didukung; tipe asli dan nilai bawaan harus cocok dengan penyedia yang dipilih.
MySQLTidak ada daftar skalar atau opsi skema sumber data. Validasi referential-action mengikuti relationMode yang dipilih.
SQLiteTidak ada atribut tipe @db asli Prisma, daftar skalar, atau opsi skema sumber data.
SQL ServerTidak ada blok enum, kolom Json, atau daftar skalar. Deklarasi multi-skema didukung.
MongoDBGunakan relationMode = "prisma", pemetaan _id, dan tipe skalar/asli ObjectId yang cocok. Blok tipe komposit termasuk dalam konektor ini.

Jelajahi, ekspor & simpan

  1. Cari penjelajah berdasarkan model, bidang, nama yang dipetakan, enum, atau relasi. Pilih relasi untuk meninjau bidang, referensi, kardinalitas, dan tindakan referensialnya di Inspektur Relasi; fokuskan salah satu titik akhir dari sana.
  2. Gunakan lokasi diagnostik untuk melompat ke sumber yang memerlukan perhatian. Sesuaikan tata letak dan preferensi tampilan pada ERD.
  3. Ekspor diagram sebagai PNG, SVG dengan gambar, atau PDF untuk dokumen atau presentasi.
  4. Masuk untuk menyimpan file Prisma dengan konteks sumber dan perender-nya. Simpan suntingan sebelum membagikan tautan publik baca-saja. Penampil yang dibagikan tidak menerima akses penyuntingan sumber.

Memecahkan masalah skema Prisma

Memecahkan masalah skema Prisma
GejalaApa yang harus diperiksa
Relasi memiliki peringatanPeriksa bidang berlawanan yang cocok dan nama relasi, tipe skalar/asli yang kompatibel, kunci yang direferensikan secara unik secara global, dan bidang/referensi hanya pada sisi pemilik.
Relasi satu-ke-satu memiliki peringatanJadikan grup kunci asing pemilik unik secara global dan relasi kebalikannya opsional. Jika skalar pemilik dapat bernilai null, buat relasinya opsional juga.
Kunci gabungan tidak ditampilkan sebagai unik secara globalPeriksa nama bidang yang hilang, berulang, opsional, atau memiliki huruf besar-kecil yang berbeda. Predikat unik parsial ditampilkan sebagai PUQ alih-alih UQ global.
Tepi banyak-ke-banyak implisit tidak adaSetiap model memerlukan satu @id tingkat bidang skalar. Gunakan model gabungan yang eksplisit untuk pengenal komposit atau atribut relasi.
Diagram dirender dengan kesalahanBidang yang dapat dibaca sengaja dipertahankan. Perbaiki diagnostik sebelum memperlakukan skema sebagai valid untuk penyedia basis datanya.
Tata letak yang disimpan tidak mencerminkan pengeditan baruSimpan konteks sumber dan perender saat ini sebelum membagikan atau memuat ulang; penampil publik melihat versi yang disimpan.
Penyuntingan sumber dinonaktifkanPeriksa kepemilikan dokumen, masuk, dan apakah pemuatan cloud telah selesai. Kesalahan muat yang dapat dipulihkan menyediakan Coba lagi dan Buka file.

Hasilkan Prisma dengan penyedia yang tepat

Salin panduan ini sebagai prompt AI, beri nama versi Prisma dan penyedia Anda, lalu nyatakan model dan aturan bisnis Anda. Minta asisten untuk mempertahankan nama @map dan @@map yang ada sambil mengubah skema.

Tempel Prisma yang dikembalikan ke dalam editor dan tinjau diagnostik sebelum menggunakannya di tempat lain. Diagram yang dirender tidak menggantikan validasi penyedia atau tinjauan migrasi.

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