ข้ามไปยังเอกสาร

โมเดลของคุณ ในรูปแบบภาพ

คู่มือ Prisma เป็น ERD

แสดง schema.prisma เป็นภาพพร้อมโมเดล ความสัมพันธ์ และชื่อที่แมปไว้ ทำความเข้าใจไวยากรณ์และแก้ปัญหาที่ตรวจพบ

schema.prisma → แผนภาพ ERเปิด Prisma เป็น ERD

ดูโครงสร้างของสคีมา Prisma ของคุณ

วาง schema.prisma ลงในตัวแก้ไขเพื่อแสดงภาพโมเดล, ฟิลด์สเกลาร์, คีย์, enums, ดัชนี และความสัมพันธ์ การแปลงจะทำงานในเบราว์เซอร์และคงโมเดลที่อ่านได้ไว้เมื่อการวินิจฉัยต้องการความสนใจ

เครื่องมือนี้แสดงภาพสคีมาของคุณ มันไม่ได้เชื่อมต่อกับแหล่งข้อมูลของคุณ เรียกใช้ Prisma Client หรือใช้การย้ายข้อมูล (migrations)

ตัวอย่างเหล่านี้ใช้ไวยากรณ์แหล่งข้อมูลของ Prisma 6 ใน Prisma 7 ให้เก็บ provider ไว้ใน schema.prisma และกำหนดค่า URL การเชื่อมต่อใน prisma.config.ts Erd Go ยอมรับแหล่งข้อมูลที่มีเฉพาะ provider เท่านั้น ให้วางสคีมาที่นี่ ไม่ใช่ไฟล์กำหนดค่าหรือข้อมูลรับรองของคุณ

วางสคีมาที่เชื่อมต่อกัน

  1. เปิด Prisma เป็น ERD และเลือกตัวอย่างหรือเอกสารเปล่า
  2. วางสคีมาด้านล่าง หรือ schema.prisma ที่สมบูรณ์ของคุณเอง ผู้ให้บริการแหล่งข้อมูลจะควบคุมการตรวจสอบเฉพาะตัวเชื่อมต่อ
  3. ตรวจสอบแผนภาพและการวินิจฉัย จากนั้นตรวจสอบโมเดล ฟิลด์ และความสัมพันธ์ในตัวสำรวจ ใช้ตัวควบคุมเค้าโครงเพื่อจัดเรียงแผนภาพ
Prisma / สคีมา 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])
}
DATABASE_URL เป็นส่วนหนึ่งของตัวอย่างสคีมา ตัวแสดงผลไม่ได้ใช้เพื่อสร้างการเชื่อมต่อฐานข้อมูล

โมเดล, ฟิลด์ และชื่อที่แมปไว้

โมเดล, ฟิลด์ และชื่อที่แมปไว้
ไวยากรณ์ความหมาย
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) ที่ชัดเจนสำหรับฟิลด์เพิ่มเติม คีย์ที่ซับซ้อน หรือการดำเนินการอ้างอิง

Prisma / ความสัมพันธ์แบบหนึ่งต่อหนึ่ง
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?
}
ดัชนีเฉพาะบางส่วนจะปรากฏเป็น PUQ ความเป็นเอกลักษณ์ของดัชนีเหล่านี้ใช้กับแถวที่ตรงกันเท่านั้น ดังนั้นจึงไม่สามารถสร้างตัวตนทั่วโลกหรือบ่งบอกถึงคาร์ดินาลิตี้แบบหนึ่งต่อหนึ่งได้

Enums, คีย์ผสม & การแมปฐานข้อมูล

ใช้ @@id และ @@unique สำหรับคีย์หลายคอลัมน์, @map สำหรับชื่อฟิลด์ และ @@map สำหรับชื่อตาราง สำหรับผู้ให้บริการหลายสคีมาที่เข้ากันได้ ให้ระบุสคีมาในแหล่งข้อมูลและกำหนดโมเดลด้วย @@schema ชื่อโมเดลยังคงมีประโยชน์ในตัวแก้ไขในขณะที่ข้อมูลระบุตัวตนที่แมปไว้จะถูกเก็บไว้สำหรับเอาต์พุตฐานข้อมูล

ตัวอย่าง PostgreSQL ด้านล่างมีคีย์หลักแบบผสมและอีเมลที่ไม่ซ้ำกันซึ่งกำหนดขอบเขตตามผู้เช่า ความสัมพันธ์ที่ชัดเจนกับคีย์นี้ต้องระบุ tenantId และ accountId ในลำดับเดียวกันด้วยประเภทฟิลด์ที่เข้ากันได้

Prisma / สคีมาคีย์ผสมที่แมปไว้
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 ที่ตรงกัน บล็อกประเภทคอมโพสิตเป็นของตัวเชื่อมต่อนี้

สำรวจ, ส่งออก และบันทึก

  1. ค้นหาใน explorer ตามโมเดล ฟิลด์ ชื่อที่แมป enum หรือความสัมพันธ์ เลือกความสัมพันธ์เพื่อตรวจสอบฟิลด์ การอ้างอิง คาร์ดินาลิตี้ และการดำเนินการอ้างอิงใน Relation Inspector; โฟกัสที่จุดสิ้นสุดใดจุดหนึ่งจากที่นั่น
  2. ใช้ตำแหน่งการวินิจฉัยเพื่อกระโดดไปยังแหล่งที่มาที่ต้องการความสนใจ ปรับเค้าโครงและการตั้งค่าการแสดงผลบน ERD
  3. ส่งออกแผนภาพเป็น PNG, SVG ที่มีรูปภาพประกอบ หรือ PDF สำหรับเอกสารหรือการนำเสนอ
  4. ลงชื่อเข้าใช้เพื่อบันทึกไฟล์ Prisma พร้อมบริบทของซอร์สและตัวเรนเดอร์ บันทึกการแก้ไขก่อนแชร์ลิงก์สาธารณะแบบอ่านอย่างเดียว ผู้ดูที่แชร์จะไม่ได้รับสิทธิ์ในการแก้ไขซอร์ส

แก้ไขปัญหาสคีมา Prisma

แก้ไขปัญหาสคีมา Prisma
อาการสิ่งที่ควรตรวจสอบ
ความสัมพันธ์มีคำเตือนตรวจสอบฟิลด์ตรงข้ามและชื่อความสัมพันธ์ที่ตรงกัน, ประเภทสเกลาร์/เนทีฟที่เข้ากันได้, คีย์อ้างอิงที่เป็นเอกลักษณ์ทั่วโลก และฟิลด์/การอ้างอิงเฉพาะฝั่งที่เป็นเจ้าของ
ความสัมพันธ์แบบหนึ่งต่อหนึ่งมีคำเตือนทำให้กลุ่มคีย์นอกที่เป็นเจ้าของมีความเป็นเอกลักษณ์ทั่วโลกและทำให้ความสัมพันธ์แบบผกผันเป็นทางเลือก หากสเกลาร์ที่เป็นเจ้าของสามารถเป็นค่าว่างได้ ให้ทำให้ความสัมพันธ์ของมันเป็นทางเลือกด้วย
คีย์ผสม (Compound key) ไม่ได้แสดงว่าเป็นเอกลักษณ์ในระดับสากลตรวจสอบชื่อฟิลด์ที่ขาดหายไป, ซ้ำกัน, เป็นทางเลือก หรือใช้ตัวพิมพ์ต่างกัน เพรดิเคตที่ไม่ซ้ำกันบางส่วน (partial unique predicate) จะแสดงเป็น PUQ แทนที่จะเป็น UQ ทั่วโลก
ไม่มีขอบแบบ many-to-many โดยนัยแต่ละโมเดลต้องการฟิลด์ระดับสเกลาร์ @id หนึ่งรายการ ใช้โมเดลการเชื่อมต่อแบบชัดเจนสำหรับตัวระบุแบบผสมหรือแอตทริบิวต์ความสัมพันธ์
แผนภาพแสดงผลพร้อมข้อผิดพลาดฟิลด์ที่อ่านได้จะถูกเก็บไว้โดยเจตนา โปรดแก้ไขการวินิจฉัยก่อนที่จะถือว่าสคีมานั้นถูกต้องสำหรับผู้ให้บริการฐานข้อมูลของคุณ
เค้าโครงที่บันทึกไว้ไม่สะท้อนถึงการแก้ไขใหม่บันทึกบริบทแหล่งที่มาและตัวแสดงผลปัจจุบันก่อนแชร์หรือโหลดซ้ำ ผู้ดูสาธารณะจะเห็นเวอร์ชันที่บันทึกไว้
การแก้ไขซอร์สถูกปิดใช้งานตรวจสอบความเป็นเจ้าของเอกสาร การลงชื่อเข้าใช้ และว่าการโหลดบนคลาวด์เสร็จสมบูรณ์หรือไม่ ข้อผิดพลาดในการโหลดที่กู้คืนได้จะมีตัวเลือก ลองใหม่ และ เปิดไฟล์

สร้าง Prisma ด้วยผู้ให้บริการที่ถูกต้อง

คัดลอกคู่มือนี้เป็น AI prompt ระบุเวอร์ชัน Prisma และผู้ให้บริการของคุณ จากนั้นระบุโมเดลและกฎทางธุรกิจของคุณ ขอให้ผู้ช่วยรักษาชื่อ @map และ @@map ที่มีอยู่เดิมไว้ในขณะที่เปลี่ยนสคีมา

วาง Prisma ที่ส่งคืนลงในตัวแก้ไขและตรวจสอบการวินิจฉัยก่อนนำไปใช้ที่อื่น แผนภาพที่แสดงผลไม่ได้แทนที่การตรวจสอบของผู้ให้บริการหรือการตรวจสอบการย้ายข้อมูล

AI request / คำขอ Prisma AI
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.