MODEL ANDA, DIVISUALISASIKAN
Panduan Prisma ke ERD
Visualisasikan schema.prisma dengan model, relasi, dan nama yang dipetakan. Pahami sintaks dan perbaiki diagnostik.
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
- Buka Prisma ke ERD dan pilih sampel atau dokumen kosong.
- Tempel skema di bawah ini, atau schema.prisma lengkap Anda sendiri. Penyedia sumber data mengontrol validasi khusus konektor.
- Tinjau diagram dan diagnostik, lalu periksa model, kolom, dan relasi di penjelajah. Gunakan kontrol tata letak untuk mengatur diagram.
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])
}Model, bidang & nama yang dipetakan
| Sintaksis | Arti |
|---|---|
| model User { ... } | Model dengan bidang skalar dan relasi. |
| String / Int / Boolean / DateTime / Decimal / Json / Bytes | Tipe 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. |
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.
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?
}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.
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 | Panduan spesifik konektor |
|---|---|
| PostgreSQL / CockroachDB | Daftar skalar dan deklarasi multi-skema didukung; tipe asli dan nilai bawaan harus cocok dengan penyedia yang dipilih. |
| MySQL | Tidak ada daftar skalar atau opsi skema sumber data. Validasi referential-action mengikuti relationMode yang dipilih. |
| SQLite | Tidak ada atribut tipe @db asli Prisma, daftar skalar, atau opsi skema sumber data. |
| SQL Server | Tidak ada blok enum, kolom Json, atau daftar skalar. Deklarasi multi-skema didukung. |
| MongoDB | Gunakan relationMode = "prisma", pemetaan _id, dan tipe skalar/asli ObjectId yang cocok. Blok tipe komposit termasuk dalam konektor ini. |
Jelajahi, ekspor & simpan
- 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.
- Gunakan lokasi diagnostik untuk melompat ke sumber yang memerlukan perhatian. Sesuaikan tata letak dan preferensi tampilan pada ERD.
- Ekspor diagram sebagai PNG, SVG dengan gambar, atau PDF untuk dokumen atau presentasi.
- 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
| Gejala | Apa yang harus diperiksa |
|---|---|
| Relasi memiliki peringatan | Periksa 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 peringatan | Jadikan 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 global | Periksa 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 ada | Setiap model memerlukan satu @id tingkat bidang skalar. Gunakan model gabungan yang eksplisit untuk pengenal komposit atau atribut relasi. |
| Diagram dirender dengan kesalahan | Bidang yang dapat dibaca sengaja dipertahankan. Perbaiki diagnostik sebelum memperlakukan skema sebagai valid untuk penyedia basis datanya. |
| Tata letak yang disimpan tidak mencerminkan pengeditan baru | Simpan konteks sumber dan perender saat ini sebelum membagikan atau memuat ulang; penampil publik melihat versi yang disimpan. |
| Penyuntingan sumber dinonaktifkan | Periksa 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.
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.