نماذجك، مرئية
دليل Prisma إلى ERD
اعرض schema.prisma بصريًا بنماذجه وعلاقاته والأسماء المعيّنة. افهم الصياغة وعالج رسائل التشخيص.
اعرض هيكل مخطط Prisma الخاص بك
الصق schema.prisma في المحرر لتصور النماذج، والحقول العددية، والمفاتيح، والتعدادات، والفهارس، والعلاقات. يتم تشغيل التحويل في المتصفح ويحافظ على نماذج قابلة للقراءة عندما تحتاج التشخيصات إلى الانتباه.
تقوم هذه الأداة بتصور المخطط الخاص بك. وهي لا تتصل بمصدر البيانات الخاص بك، أو تشغيل Prisma Client، أو تطبيق عمليات الترحيل.
تستخدم أمثلة Prisma 6 نحواً لمصدر البيانات. في Prisma 7، احتفظ بالمزوِّد في schema.prisma وقم بتكوين عنوان URL للاتصال في prisma.config.ts. يقبل Erd Go مصدر بيانات للمزوِّد فقط؛ الصق المخطط هنا، وليس ملف التكوين أو بيانات الاعتماد الخاصة بك.
لصق مخطط متصل
- افتح 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]) | قيد فريد أحادي الحقل / مركب. |
| @default(...) / @updatedAt / @db.VarChar(255) | القيم الافتراضية، وتحديث بيانات التعريف، والأنواع الأصلية الخاصة بمزود الخدمة. |
| @map("user_id") / @@map("users") | اسم العمود المعين / جدول قاعدة البيانات. |
| enum Status { ... } / @@index([field]) | قيم التعداد / فهارس النموذج. |
| @@schema("public") | عضوية المخطط لموفر مصدر بيانات متوافق متعدد المخططات. |
العلاقات وقواعد المفاتيح
تستخدم العلاقة الصريحة حقل علاقة، وحقول مفتاح أجنبي قياسية، و @relation(fields: [...], references: [...]). قم بتضمين حقل علاقة مقابل في النموذج الآخر. قم بالإشارة إلى مفتاح أساسي أو مفتاح فريد عالمياً بأنواع قياسية وأصلية متوافقة.
إذا كان أي عدد قياسي للمفتاح الخارجي اختيارياً، فيجب أن يكون حقل العلاقة التابع له اختيارياً أيضاً. قد تحتوي العلاقة الاختيارية على قيم قياسية مطلوبة. يحتاج مالك العلاقة الفردية (one-to-one) إلى @unique أو @@unique على حقول مفتاحه الخارجي، ويجب أن يكون حقل الانعكاس بدون تلك القيم القياسية اختيارياً.
استخدم نفس اسم العلاقة المقتبس على كلا الجانبين للتمييز بين روابط متعددة بين نفس النماذج أو علاقة ذاتية. قد تحتوي الأسماء على علامات ترقيم. أسماء الحقول ومراجع المفاتيح حساسة لحالة الكصوص؛ ادرج كل حقل مفتاح مرة واحدة وقم تضمين كل عضو مفتاح مركب.
تتطلب الحواف الضمنية للعلاقات متعددة إلى متعدد (many-to-many) معرفاً ثنائياً قياسياً واحداً (@id) على مستوى الحقل في كل نموذج مشارك. تؤدي المُعرّفات المركبة، أو على مستوى الكتلة، أو الفريدة فقط إلى إصدار تشخيص بدلاً من علاقة افتراضية مضللة. استخدم نموذج ربط صريح للحصول على حقول إضافية، أو مفاتيح معقدة، أو إجراءات مرجعية.
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?
}التعدادات، المفاتيح المركبة وتعيينات قواعد البيانات
استخدم @@id و @@unique للمفاتيح متعددة الأعمدة، و @map لأسماء الحقول، و @@map لأسماء الجداول. بالنسبة لموفر متعدد المخططات متوافق، قم سرد المخططات في مصدر البيانات و تعيين النماذج باستخدام @@schema. يظل اسم النموذج مفيداً في المحرر بينما يتم الاحتفاظ بالهوية المعينة لإخراج قاعدة البيانات.
يحتوي مثال PostgreSQL أدناه على مفتاح أساسي مركب بريد إلكتروني فريد مقيد بالنطاق المستأجر (tenant-scoped). يجب أن توفر العلاقة الصريحة بهذا المفتاح 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 | لا توجد قوائم قياسية أو خيار مخططات مصادر البيانات. يتبع التحقق من صحة إجراءات الإحالة وضع العلاقة المختار (relationMode). |
| SQLite | لا توجد سمات نوع @db أصلية في Prisma، أو قوائم قياسية، أو خيار مخططات مصادر البيانات (datasource schemas). |
| SQL Server | لا توجد كتل تعداد، أو حقول Json، أو قوائم قياسية. يتم دعم إعلانات المخططات المتعددة. |
| MongoDB | استخدم relationMode = "prisma"، وتعيين _id، وأنواع ObjectId العددية/الأصلية المتطابقة. تنتمي كتل الأنواع المركبة إلى هذا الموصل. |
الاستكشاف والتصدير والحفظ
- ابحث في المستكشف حسب النموذج، أو الحقل، أو الاسم المُعيّن، أو التعداد، أو العلاقة. حدد علاقة لمراجعة حقولها، ومراجعها، والتعددية، وإجراءات الإحالة في مراقب العلاقات (Relation Inspector)؛ وركز على أي من نقطتي النهاية من هناك.
- استخدم مواقع التشخيص للانتقال إلى المصدر الذي يتطلب الانتباه. اضبط تفضيلات التخطيط والعرض على ERD.
- قم بتصدير المخطط كصورة PNG أو SVG مدعومة بالصور أو PDF لمستند أو عرض تقديمي.
- سجل الدخول لحفظ ملف Prisma مع سياق المصدر والعارض الخاص به. احفظ التعديلات قبل مشاركة رابط عام للقراءة فقط. لا يحصل المشاهد المشارك على صلاحية تحرير المصدر.
استكشاف أخطاء مخطط Prisma وإصلاحها
| العرض | ما يجب التحقق منه |
|---|---|
| علاقة تحتوي على تحذير | تحقق من الحقل المقابل المطابق واسم العلاقة، والأنواع العددية/الأصلية المتوافقة، والمفتاح المُشار إليه الفريد عالمياً، والحقول/المراجع الموجودة فقط في جانب الملكية. |
| علاقة فردية تحتوي على تحذير | اجعل مجموعة المفاتيح الخارجية المالكة فريدة عالمياً وعلاقة الانعكاس اختيارية. إذا كان الحقل القياسي المالِك قابلاً لقبلول قيم فارغة، فاجعل علاقته اختيارية أيضاً. |
| المفتاح المركب لا يُعرض كفريد على مستوى النظام ككل | تحقق من أسماء الحقول المفقودة، أو المتكررة، أو الاختيارية، أو ذات الأحرف المختلفة. يتم عرض محدد فرع جزئي كـ PUQ بدلاً من UQ العام. |
| مخطط ضمني من عدة إلى عدة غير موجود | يحتاج كل نموذج إلى حقل سلالي مفرد بمستوى @id. استخدم نموذج ربط صريح للمعرفات المركبة أو سمات العلاقات. |
| يتم عرض الرسم التخطيطي مع أخطاء | الحتفاظ بالحقول القابلة للقراءة عن قصد. قم بإصلاح التشخيصات قبل اعتبار المخطط صالحاً لموفر قاعدة البيانات الخاص به. |
| التخطيط المحفوظ لا يعكس التعديلات الجديدة | احفظ المصدر الحالي وسياق العرض قبل المشاركة أو إعادة التحميل؛ يرى المشاهدون العامون الإصدار المحفوظ. |
| تحرير المصدر معطل | تحقق من ملكية المستند وتسجيل الدخول وما إذا كان التحميل السحابي قد انتهى. توفر أخطاء التحميل القابلة للاسترداد إعادة المحاولة (Retry) وفتح الملفات. |
إنشاء Prisma بالمزود الصحيح
انسخ هذا الدليل كموجه ذكاء اصطناعي، وقم بتسمية إصدار و موفر 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.