نظرة عامة تنفيذية والأهمية المعمارية
يُقدم إصدار Prisma v8.0.0-rc.22 تحسينات معمارية جوهرية عبر طبقات تعيين الكائنات العلائقية (ORM)، ومحركات الاستعلام، وتكاملات موفري قواعد البيانات. يمثل هذا الإصدار خطوة تطورية ناضجة لـ Prisma 8، مع التركيز على الأمان الصارم للأنواع، والتحكم الصريح في تخطيطات تخزين قواعد البيانات الأصلية، والتوافق بين نماذج تنفيذ SQL و NoSQL. من خلال تبسيط طريقة تهيئة برامج تشغيل قواعد البيانات وسياقات التنفيذ، تواصل Prisma القضاء على التجريدات المخفية، مما يمنح فرق الهندسة المؤسسية تفاعلات قابلة للتنبؤ وعالية الأداء مع مخازن البيانات الأساسية.
في جوهر هذا الإصدار يوجد تحول مقصود نحو حل الأنواع الصريح واتساق مستوى التخزين. في PostgreSQL، تمت إعادة هيكلة التعامل مع التاريخ، والوقت، والطابع الزمني للتوافق مع أنواع التسهيلات القياسية بدلاً من الحشو القسري، مما يبسط بشكل كبير قابلية التشغيل البيني مع مخططات قواعد البيانات الحالية. وفي الوقت نفسه، تمت ترقية MongoDB لتصل إلى مستوى التوافق التام من الدرجة الأولى مع محركات SQL، دمجاً لأنماط كومة التنفيذ الموحدة. تُلغي هذه التعديلات حالات التحليل الغامضة وتقلل من الحمل الزائد لوقت التشغيل، مما يعزز تمركز Prisma كأداة لإدارة المخططات والاستعلامات على مستوى المؤسسات.
التحسينات الأساسية وبيئة عمل المطورين
تشهد بيئة عمل المطورين قفزة كبيرة إلى الأمام مع توحيد سياقات التنفيذ عبر نماذج قواعد البيانات المختلفة. يقبل منشئ الاستعلامات في MongoDB، والمسار الخام (raw lane)، وORM، والأنظمة الفرعية لوقت التشغيل الآن سياق تنفيذ موحدًا عبر mongoStatic({ contract }) أو mongo({ contract })، مما يعكس النمط القوي الذي أنشأته محركات SQL. يضمن هذا النمط حدوث التحقق من العقدة بدقة مرة واحدة أثناء التهيئة، مما يمنع دورات التحليل الزائدة أثناء معالجة الطلبات عالية الإنتاجية. علاوة على ذلك، يتم الآن إنشاء برامج تشغيل MongoDB ديناميكيًا مباشرة من مُوصّفات وقت التشغيل الخاصة بها على كومة التنفيذ، مما يبسط إدارة الاتصالات ويجرد منطق الاتصال التقليدي.
تم توسيع دعم PostgreSQL بشكل كبير لاستيعاب نظامات بيئة الإضافات المؤسسية المعقدة. يمكن للمطورين الآن الإعلان صراحة عن إضافات قواعد البيانات المطلوبة - مثل pgvector، أو PostGIS، أو ParadeDB، أو حزمة citext الجديدة - مباشرة داخل عقود المخططات الخاصة بهم، مما يضمن أن أوامر prisma db sign تقوم بتوفير والتحقق من البيئات المستهدفة بدقة. علاوة على ذلك، تم تحسين محرك القراءة في Prisma 7 لاستيعاب جميع أنواع Postgres الأصلية @db.* بشكل شامل، بينما تستفيد MySQL من قدرات القراءة المُقدّمة حديثًا لمنشئ SQL وORM. كما تم تشديد حواجز الأمان: سيقوم وقت تشغيل Prisma ORM الآن برفض التنفيذ بصرامة في حالة اكتشاف نسخ متعددة في شجرة الوحدة، كما أن استدعاء connect() على عميل تم تهيئته مسبقًا أصبح مضمونًا ليكون آمنًا وخاملًا (idempotent).
مصفوفة المقارنة المعمارية
| الميزة / المقاييس | خط الأساس السابق | Prisma v8.0.0-rc.22 | التأثير المعمارى |
|---|---|---|---|
| التعامل مع التاريخ/الوقت (PostgreSQL) | حشو قسري لـ Temporal على DateTime، وDate، وTime |
أنواع تسهيلات تُعيّن لأنواع SQL الأصلية (timestamptz، وdate، وtime، وinterval) |
يزيل الحمل الزائد للحشو، ويُطابق أنواع قواعد البيانات الأصلية مباشرة مع البدائيات وصيغ النصوص في JavaScript. |
| تهيئة MongoDB | إنشاء مجزأ عبر مُنفذين متفرقين، وتعدادات، وخرائط تكوين | سياق تنفيذ موحد (mongoStatic) ومُوصّفات برنامج تشغيل وقت التشغيل |
يوحد خطوط أنابيب التمهيد عبر محركات SQL وNoSQL، مما يقلل من زمن الانتقال للتهيئة. |
| تخزين كائنات القيمة | تُحفظ بشكل مرن في مستوى النطاق (domain plane) | نُقلت مباشرة إلى مستوى التخزين مع قيود CHECK تلقائية في PostgreSQL | يفرض سلامة مستوى قاعدة البيانات، مما يحول تعديلات مخطط كائنات القيمة إلى عمليات ترحيل صريحة. |
| أمان العميل والتزامن | عرضة لفشل وقت التشغيل الصامت عند وجود نسخ متعددة للحزم | فحص صارم للنسخة الفردية يرمي خطأ عند وجود نسخ مكررة؛ دالة connect() خاملة |
يقضي على تسريبات الذاكرة الدقيقة، واختلافات الإصدارات، وحالات سباق الاتصال المزدوج. |
التغييرات الجذرية وتحذيرات الترحيل
يُقدم إصدار Prisma v8.0.0-rc.22 العديد من التغييرات الجذرية التي تتطلب تنفيذًا دقيقًا لمسارات الترقية المقدمة. في PostgreSQL، لم تعد حقول DateTime، وDate، وTime تعود افتراضيًا إلى قيم Temporal. بدلاً من ذلك، تعمل كأنواع تسهيلات (timestamptz(3)، والتواريخ/الأوقات المدعومة بالنصوص، وفترات ISO 8601). يجب على الفرق التي تعتمد على سلوك Temporal القديم إعادة تسمية الحقول صراحة إلى TimestamptzTemporal أو DateTemporal أو TimeTemporal، وتحديث مساعدات TypeScript وفقًا لذلك.
بالإضافة إلى ذلك، تم نقل كائنات القيمة من مستوى النطاق إلى مستوى التخزين. يعنى هذا التوافق المعمارى أن تحديث كائن قيمة يغير تجزئة التخزين الأساسية، مما يصنف التغيير كعملية ترحيل رسمية لقاعدة البيانات. ستقوم PostgreSQL الآن تلقائيًا باستنتاج وفرض قيود CHECK لكائنات القيمة وأعمدة التمييز. ستؤدي محاولة نشر ملفات contract.json القديمة التي تحتوي على كائنات قيمة بمستوى النطاق إلى فشل فوري في التحقق (CONTRACT.VALIDATION_FAILED). يجب على المطورين استخدام نصوص الترحيل الواردة في وصفات الترقية الرسمية لإعادة كتابة عقودهم، ولقطاتهم، وترحيلاتهم قبل إعادة إرسال وتوقيع قواعد بياناتهم.
دليل الترقية خطوة بخطوة
تتطلب الترقية إلى Prisma v8.0.0-rc.22 اتباع وصفات الترقية الرسمية للتطبيقات والإضافات. قم بتنفيذ خطوات الترحيل بالترتيب الدقيق الموضح أدناه لضمان مزامنة العقود وسلامة قاعدة البيانات.
تشغيل أداة إعادة كتابة كائنات القيمة وتحديث المخطط: قم بتنفيذ نص الترقية التلقائي للتطبيق لترحيل كائنات القيمة إلى مستوى التخزين، وتحديث حقول التاريخ/الوقت في PostgreSQL إذا كنت بحاجة إلى سلوك زمني قديم:
model Event { id Int @id at TimestamptzTemporal day DateTemporal opensAt TimeTemporal(0) }تحديث تهيئة عميل MongoDB وSQL: قم بإعادة هيكلة كود تهيئة MongoDB الخاص بك لاستخدام نمط سياق التنفيذ الثابت الجديد بدلاً من تمرير العقود الخام مباشرة إلى منشئي الاستعلامات الفرديين:
import mongoStatic from '@prisma/orm-mongo/static'; const { query, raw } = mongoStatic({ contract });إصدار العقود وتوقيع قواعد البيانات: بعد
