โมเดลของคุณ ในรูปแบบภาพ
คู่มือ Prisma เป็น ERD
แสดง schema.prisma เป็นภาพพร้อมโมเดล ความสัมพันธ์ และชื่อที่แมปไว้ ทำความเข้าใจไวยากรณ์และแก้ปัญหาที่ตรวจพบ
ดูโครงสร้างของสคีมา Prisma ของคุณ
วาง schema.prisma ลงในตัวแก้ไขเพื่อแสดงภาพโมเดล, ฟิลด์สเกลาร์, คีย์, enums, ดัชนี และความสัมพันธ์ การแปลงจะทำงานในเบราว์เซอร์และคงโมเดลที่อ่านได้ไว้เมื่อการวินิจฉัยต้องการความสนใจ
เครื่องมือนี้แสดงภาพสคีมาของคุณ มันไม่ได้เชื่อมต่อกับแหล่งข้อมูลของคุณ เรียกใช้ Prisma Client หรือใช้การย้ายข้อมูล (migrations)
ตัวอย่างเหล่านี้ใช้ไวยากรณ์แหล่งข้อมูลของ Prisma 6 ใน Prisma 7 ให้เก็บ provider ไว้ใน schema.prisma และกำหนดค่า URL การเชื่อมต่อใน prisma.config.ts Erd Go ยอมรับแหล่งข้อมูลที่มีเฉพาะ provider เท่านั้น ให้วางสคีมาที่นี่ ไม่ใช่ไฟล์กำหนดค่าหรือข้อมูลรับรองของคุณ
วางสคีมาที่เชื่อมต่อกัน
- เปิด Prisma เป็น ERD และเลือกตัวอย่างหรือเอกสารเปล่า
- วางสคีมาด้านล่าง หรือ schema.prisma ที่สมบูรณ์ของคุณเอง ผู้ให้บริการแหล่งข้อมูลจะควบคุมการตรวจสอบเฉพาะตัวเชื่อมต่อ
- ตรวจสอบแผนภาพและการวินิจฉัย จากนั้นตรวจสอบโมเดล ฟิลด์ และความสัมพันธ์ในตัวสำรวจ ใช้ตัวควบคุมเค้าโครงเพื่อจัดเรียงแผนภาพ
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 User { ... } | โมเดลที่มีฟิลด์สเกลาร์และฟิลด์ความสัมพันธ์ |
| String / Int / Boolean / DateTime / Decimal / Json / Bytes | ประเภทฟิลด์สเกลาร์; การรองรับตัวเชื่อมต่อยังคงมีผล |
| String? / Post[] | ฟิลด์ทางเลือก / ฟิลด์รายการ |
| @id / @@id([a, b]) | คีย์หลักแบบฟิลด์เดียว / แบบผสม |
| @unique / @@unique([a, b]) | ข้อจำกัดเฉพาะ (Unique constraint) แบบฟิลด์เดียว / แบบผสม |
| @default(...) / @updatedAt / @db.VarChar(255) | ค่าเริ่มต้น, อัปเดตข้อมูลเมตา และประเภทข้อมูลดั้งเดิมเฉพาะของผู้ให้บริการ |
| @map("user_id") / @@map("users") | ชื่อคอลัมน์ / ตารางฐานข้อมูลที่แมปไว้ |
| enum Status { ... } / @@index([field]) | ค่า Enum / ดัชนีโมเดล |
| @@schema("public") | การเป็นสมาชิกสคีมาสำหรับแหล่งข้อมูลหลายสคีมาที่เข้ากันได้ |
ความสัมพันธ์และกฎของคีย์
ความสัมพันธ์แบบชัดแจ้ง (explicit relation) ใช้ฟิลด์ความสัมพันธ์, ฟิลด์ foreign-key แบบสเกลาร์ และ @relation(fields: [...], references: [...]) ให้รวมฟิลด์ความสัมพันธ์ตรงข้ามไว้ในโมเดลอีกตัวหนึ่ง อ้างอิงคีย์หลักหรือคีย์ที่ไม่ซ้ำกันทั่วโลกด้วยประเภทสเกลาร์และประเภทเนทีฟที่เข้ากันได้
หากสเกลาร์ของคีย์นอกใดๆ เป็นทางเลือก ฟิลด์ความสัมพันธ์ที่เป็นเจ้าของจะต้องเป็นทางเลือกด้วยเช่นกัน ความสัมพันธ์ที่เป็นทางเลือกอาจมีสเกลาร์ที่จำเป็น เจ้าของแบบหนึ่งต่อหนึ่งต้องการ @unique หรือ @@unique ในฟิลด์คีย์นอกของมัน และฟิลด์ผกผันที่ไม่มีสเกลาร์เหล่านั้นจะต้องเป็นทางเลือก
ใช้ชื่อความสัมพันธ์ที่อยู่ในเครื่องหมายคำพูดเดียวกันทั้งสองด้านเพื่อแยกความแตกต่างระหว่างลิงก์หลายรายการระหว่างโมเดลเดียวกันหรือความสัมพันธ์กับตัวเอง ชื่ออาจมีเครื่องหมายวรรคตอน ชื่อฟิลด์และการอ้างอิงคีย์จะคำนึงถึงตัวพิมพ์เล็ก-ใหญ่ ให้ระบุฟิลด์คีย์แต่ละรายการหนึ่งครั้งและรวมสมาชิกคีย์ผสมทุกตัว
ความสัมพันธ์แบบกลุ่มต่อกลุ่ม (many-to-many) โดยนัยจำเป็นต้องมีฟิลด์ @id ระดับสเกลาร์หนึ่งฟิลด์ในแต่ละโมเดลที่เกี่ยวข้อง ตัวระบุแบบคอมโพสิต ระดับบล็อก หรือแบบไม่ซ้ำกันเท่านั้น จะสร้างการวินิจฉัยแทนที่จะเป็นความสัมพันธ์เสมือนที่ทำให้เข้าใจผิด ให้ใช้โมเดลการเชื่อมต่อ (join model) ที่ชัดเจนสำหรับฟิลด์เพิ่มเติม คีย์ที่ซับซ้อน หรือการดำเนินการอ้างอิง
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, คีย์ผสม & การแมปฐานข้อมูล
ใช้ @@id และ @@unique สำหรับคีย์หลายคอลัมน์, @map สำหรับชื่อฟิลด์ และ @@map สำหรับชื่อตาราง สำหรับผู้ให้บริการหลายสคีมาที่เข้ากันได้ ให้ระบุสคีมาในแหล่งข้อมูลและกำหนดโมเดลด้วย @@schema ชื่อโมเดลยังคงมีประโยชน์ในตัวแก้ไขในขณะที่ข้อมูลระบุตัวตนที่แมปไว้จะถูกเก็บไว้สำหรับเอาต์พุตฐานข้อมูล
ตัวอย่าง PostgreSQL ด้านล่างมีคีย์หลักแบบผสมและอีเมลที่ไม่ซ้ำกันซึ่งกำหนดขอบเขตตามผู้เช่า ความสัมพันธ์ที่ชัดเจนกับคีย์นี้ต้องระบุ tenantId และ accountId ในลำดับเดียวกันด้วยประเภทฟิลด์ที่เข้ากันได้
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")
}ผู้ให้บริการและการวินิจฉัยที่กู้คืนได้
ผู้ให้บริการแหล่งข้อมูลที่รองรับ ได้แก่ PostgreSQL, MySQL, SQLite, SQL Server, MongoDB และ CockroachDB ตัวแปลงจะตรวจสอบตัวตนเฉพาะของตัวเชื่อมต่อ, ประเภทเนทีฟ, ค่าเริ่มต้น, กฎความสัมพันธ์ และการชนกันของชื่อที่แมป
ผู้ให้บริการเชิงสัมพันธ์จะตั้งค่าเริ่มต้นเป็น relationMode = "foreignKeys" ส่วน MongoDB จะใช้ relationMode = "prisma" และตรวจสอบความถูกต้องของการแมป _id และข้อกำหนด ObjectId อย่าทึกทักเอาเองว่าตัวอย่างเชิงสัมพันธ์สามารถคัดลอกไปใช้กับ MongoDB ได้โดยไม่มีการเปลี่ยนแปลง
แก้ไขฟิลด์ความสัมพันธ์ตรงข้ามที่หายไป, ประเภทคีย์นอกที่ไม่เข้ากัน, เป้าหมายคีย์ที่ไม่ถูกต้อง และการรวมผู้ให้บริการที่ไม่รองรับโดยใช้การวินิจฉัย ฟิลด์ที่ไม่ถูกต้องแต่ยังอ่านได้จะยังคงมองเห็นได้เพื่อให้คุณสามารถซ่อมแซมสคีมาในตำแหน่งนั้นได้
| ผู้ให้บริการ | คำแนะนำเฉพาะสำหรับตัวเชื่อมต่อ |
|---|---|
| PostgreSQL / CockroachDB | รองรับรายการสเกลาร์และการประกาศหลายสคีมา ประเภทเนทีฟและค่าเริ่มต้นต้องตรงกับผู้ให้บริการที่เลือก |
| MySQL | ไม่มีรายการสเกลาร์หรือตัวเลือก datasource schemas การตรวจสอบความถูกต้องของการดำเนินการอ้างอิงจะเป็นไปตาม relationMode ที่เลือก |
| SQLite | ไม่มีแอตทริบิวต์ประเภท @db ดั้งเดิมของ Prisma, รายการสเกลาร์ หรือตัวเลือก datasource schemas |
| SQL Server | ไม่มีบล็อก enum, ฟิลด์ Json หรือรายการสเกลาร์ รองรับการประกาศหลายสคีมา |
| MongoDB | ใช้ relationMode = "prisma", การแมป _id และประเภทสเกลาร์/เนทีฟ ObjectId ที่ตรงกัน บล็อกประเภทคอมโพสิตเป็นของตัวเชื่อมต่อนี้ |
สำรวจ, ส่งออก และบันทึก
- ค้นหาใน explorer ตามโมเดล ฟิลด์ ชื่อที่แมป enum หรือความสัมพันธ์ เลือกความสัมพันธ์เพื่อตรวจสอบฟิลด์ การอ้างอิง คาร์ดินาลิตี้ และการดำเนินการอ้างอิงใน Relation Inspector; โฟกัสที่จุดสิ้นสุดใดจุดหนึ่งจากที่นั่น
- ใช้ตำแหน่งการวินิจฉัยเพื่อกระโดดไปยังแหล่งที่มาที่ต้องการความสนใจ ปรับเค้าโครงและการตั้งค่าการแสดงผลบน ERD
- ส่งออกแผนภาพเป็น PNG, SVG ที่มีรูปภาพประกอบ หรือ PDF สำหรับเอกสารหรือการนำเสนอ
- ลงชื่อเข้าใช้เพื่อบันทึกไฟล์ Prisma พร้อมบริบทของซอร์สและตัวเรนเดอร์ บันทึกการแก้ไขก่อนแชร์ลิงก์สาธารณะแบบอ่านอย่างเดียว ผู้ดูที่แชร์จะไม่ได้รับสิทธิ์ในการแก้ไขซอร์ส
แก้ไขปัญหาสคีมา Prisma
| อาการ | สิ่งที่ควรตรวจสอบ |
|---|---|
| ความสัมพันธ์มีคำเตือน | ตรวจสอบฟิลด์ตรงข้ามและชื่อความสัมพันธ์ที่ตรงกัน, ประเภทสเกลาร์/เนทีฟที่เข้ากันได้, คีย์อ้างอิงที่เป็นเอกลักษณ์ทั่วโลก และฟิลด์/การอ้างอิงเฉพาะฝั่งที่เป็นเจ้าของ |
| ความสัมพันธ์แบบหนึ่งต่อหนึ่งมีคำเตือน | ทำให้กลุ่มคีย์นอกที่เป็นเจ้าของมีความเป็นเอกลักษณ์ทั่วโลกและทำให้ความสัมพันธ์แบบผกผันเป็นทางเลือก หากสเกลาร์ที่เป็นเจ้าของสามารถเป็นค่าว่างได้ ให้ทำให้ความสัมพันธ์ของมันเป็นทางเลือกด้วย |
| คีย์ผสม (Compound key) ไม่ได้แสดงว่าเป็นเอกลักษณ์ในระดับสากล | ตรวจสอบชื่อฟิลด์ที่ขาดหายไป, ซ้ำกัน, เป็นทางเลือก หรือใช้ตัวพิมพ์ต่างกัน เพรดิเคตที่ไม่ซ้ำกันบางส่วน (partial unique predicate) จะแสดงเป็น PUQ แทนที่จะเป็น UQ ทั่วโลก |
| ไม่มีขอบแบบ many-to-many โดยนัย | แต่ละโมเดลต้องการฟิลด์ระดับสเกลาร์ @id หนึ่งรายการ ใช้โมเดลการเชื่อมต่อแบบชัดเจนสำหรับตัวระบุแบบผสมหรือแอตทริบิวต์ความสัมพันธ์ |
| แผนภาพแสดงผลพร้อมข้อผิดพลาด | ฟิลด์ที่อ่านได้จะถูกเก็บไว้โดยเจตนา โปรดแก้ไขการวินิจฉัยก่อนที่จะถือว่าสคีมานั้นถูกต้องสำหรับผู้ให้บริการฐานข้อมูลของคุณ |
| เค้าโครงที่บันทึกไว้ไม่สะท้อนถึงการแก้ไขใหม่ | บันทึกบริบทแหล่งที่มาและตัวแสดงผลปัจจุบันก่อนแชร์หรือโหลดซ้ำ ผู้ดูสาธารณะจะเห็นเวอร์ชันที่บันทึกไว้ |
| การแก้ไขซอร์สถูกปิดใช้งาน | ตรวจสอบความเป็นเจ้าของเอกสาร การลงชื่อเข้าใช้ และว่าการโหลดบนคลาวด์เสร็จสมบูรณ์หรือไม่ ข้อผิดพลาดในการโหลดที่กู้คืนได้จะมีตัวเลือก ลองใหม่ และ เปิดไฟล์ |
สร้าง Prisma ด้วยผู้ให้บริการที่ถูกต้อง
คัดลอกคู่มือนี้เป็น AI prompt ระบุเวอร์ชัน Prisma และผู้ให้บริการของคุณ จากนั้นระบุโมเดลและกฎทางธุรกิจของคุณ ขอให้ผู้ช่วยรักษาชื่อ @map และ @@map ที่มีอยู่เดิมไว้ในขณะที่เปลี่ยนสคีมา
วาง 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.