نظرة عامة تنفيذيّة والأهمية المعمارية
يمثل Prisma v8.0.0-rc.21 خطوة رئيسية للأمام في دورة إصدارات v8، حيث يقدم تحسينات معمارية حرجة عبر قواعد البيانات العلائقية، وMongoDB، ومعالجة الأخطاء من جانب العميل. ومع تزايد تعقيد سير عمل قواعد البيانات في المؤسسات، يصبح الحفاظ على توافق صارم للعقود بين تعريفات المخططات (schemas)، ومشغلات الترحيل، وسلوك وقت التشغيل أمراً في غاية الأهمية. يعالج هذا الإصدار الاتساق الأساسي، مما يضمن أن تعمل PostgreSQL وSQLite وMongoDB تحت خطوط أنابيب تحقق موحدة مع تشديد القدرة على التنبؤ في انتشار الأخطاء غير المتزامنة.
من منظور معماري، يقوم الإصدار v8.0.0-rc.21توحيد كيفية تقييم عقود التخزين، وبنائها، والتحقق منها. ومن خلال القضاء على مسارات التنفيذ الزائدة في تحليل عقود MongoDB - وتوحيد مدخلات TypeScript وPSL وPrisma 6 في منشئ واحد قوي - يقلل Prisma بشكل كبير من تناقضات الحالات الحدية. علاوة على ذلك، فإن إصلاح تخطيط الترحيل لتعديلات القيم المعدودة (enums) على PostgreSQL وSQLite يجعل تطور المخطط العلائقي متماشياً مع توقعات الصناعة. وبدلاً من الفشل بصمت أو يتطلب عمليات إعادة تعيين مدمرة لقواعد البيانات، توفر واجهة سطر الأوامر (CLI) الآن فحص سلامة تفاعلياً ومنظماً ومسارات استعادة صريحة لحالات العقود الخارجة عن الحدود.
التحسينات الأساسية وبيئة عمل المطورين
تحظى بيئة عمل المطورين بدفع كبير مع وصول أول حزم تخطيط وتطبيق ترحيل عامة لـ MySQL، مما يجلب تكافؤ الميزات عبر أهداف قواعد البيانات العلائقية الأساسية لـ Prisma. يستفيد مستخدمو PostgreSQL وSQLite أيضاً من الإدارة المتقدمة لدورة حياة القيم المعدودة؛ حيث يمكن لعمليات مثل migration plan و db update الآن إعادة تسمية أو حذف قيم القيم المعدودة بسلاسة مع إعادة كتابة الصفوف التابعة تلقائياً. تمت إعادة صياغة أنواع التاريخ والوقت في PostgreSQL بشكل صريح لتحديد الطبيعة الدقيقة للقيم التي تقرأها بوضوح، مما يفرض معايير تحليل ISO 8601 الصارمة بشكل موحد عبر جميع الخوادم.
في بيئة MongoDB، تم توحيد قواعد تقييم العقود بدقة. وسواء أكان ذلك من خلال تحديد المخططات عبر TypeScript أو PSL أو تنسيقات Prisma 6 القديمة، فإن كل مصدر يمر الآن عبر محرك تحقق فريد. يفرض هذا قواعد تعدد الأشكال الصارمة - مثل اشتراط أن تكون المميزات (discriminators) حقولاً نصية وغير اختيارية - ويزيل تعريفات الفهارس المكررة تلقائياً. بالإضافة إلى ذلك، تم إيقاف الإعدادات المسبقة للحقول لصالح مُنشئي الأنواع الصريحة وأسماء الأنواع المستعارة، مما يسهل النموذج العقلي لتكوين المخططات ويحسن الأمان العام للنوع عبر نطاق التطبيقات المعقدة.
مصفوفة المقارنة المعمارية
| الميزة / المقاييس | الخط الأساسي السابق (ما قبل الإصدار المرشح v8.0.x) | Prisma v8.0.0-rc.21 | الأثر المعماري |
|---|---|---|---|
| وظيفة تأخير خطأ العميل | طرح متزامن فوري عند الاستدعاء | رفض الوعد/النتيجة (Promise/Result) عند الانتظار/القراءة (await/read) |
يزيل أعطال التنفيذ المتزامنة غير المعالجة؛ ويتكامل بسلاسة مع Promise.allSettled. |
| منشئو عقود MongoDB | محللات مجزأة عبر TS وPSL | خط أنابيب بناء موحد | يضمن قواعد تحقق متطابقة بغض النظر عن تنسيق إدخال المخطط. |
| تعديل القيم المعدودة (PG/SQLite) | فشل أو تجاهل القيم غير المعالجة | موجه تفاعلي أو علامات سطر أوامر صريحة (--rename/--delete) |
يمنع تلف البيانات الصامت ويؤتمت تحويلات البيانات على مستوى الصف. |
| دعم ترحيل MySQL | تجريبي / داخلي فقط | أول حزم ترحيل عامة ومستقرة | يُنشئ تكافؤاً كاملاً للإنتاج لإدارة دورة حياة قاعدة بيانات MySQL. |
التغييرات الجذرية وتنبيهات الترحيل
يقدم Prisma v8.0.0-rc.21 العديد من التغييرات الجذرية المتعمدة المصممة لتعزيز القدرة على التنبؤ بوقت التشغيل. والأبرز من ذلك، أن أعضاء العميل على مثيلات postgres() و sqlite() و supabase() المرتبطة بالأدوار تُرجع الآن وعداً أو نتيجة مرفوضة بدلاً من الطرح المتزامن عند استدعائها على عميل مغلق، أو اتصال فاشل، أو معاملة منتهية. ونتيجة لذلك، فإن كتل try/catch القديمة المحيطة باستدعاءات قاعدة البيانات غير المتزامنة بدون كلمة مفتاحية صريحة await ستفشل في اكتشاف أخطاء الاتصال؛ يجب على المطورين التأكد من انتظار الاستدعاءات بشكل صحيح.
بالإضافة إلى ذلك، تتطلب عقود MongoDB تكوينات حزمة هدف صريحة (mongoContract(path, { target }))، وتم فصل دورات حياة اتصال قاعدة البيانات عن تجمعات الاتصالات الخارجية. سيؤدي استدعاء close() على عميل Prisma الآن إلى إنهاء وقت تشغيله الداخلي بقوة حتى إذا تم توفير تجمع pg.Pool خارجي. أخيرًا، ستتغير تجزئات المخطط لتكوينات Prisma 6 التي تحتوي على فهارس مكررة عند الإصدار، مما يتطلب عملية توقيع ثانوية.
دليل الترقية خطوة بخطوة
تتطلب الترقية إلى الإصدار v8.0.0-rc.21 التحقق الدقيق من روتين معالجة الأخطاء غير المتزامنة وتكوينات العقود المحدثة. اتبع هذه الخطوات للانتقال بنجاح:
تحديث الحزم وإعادة تشغيل إصدار العقد: قم بتحديث حزم Prisma الخاصة بك إلى
v8.0.0-rc.21ونفذ مُصدر العقود لمزامنة طوابع العناصر:prisma contract emitإعادة هيكلة معالجة الأخطاء غير المتزامنة: قم بمراجعة قاعدة بيانات الكود الخاصة بك بحثاً عن كتل
try/catchالمتزامنة المحيطة باستعلامات قاعدة البيانات وقم بإضافة كلمة المرورawaitقبلها:// قبل التعديل try { db.transaction(work); } catch (error) { handle(error); } // بعد التعديل try { await db.transaction(work); } catch (error) { handle(error); }تحديث إعلانات عقود MongoDB: إذا كنت تستخدم MongoDB، فتأكد من أن استدعاء منشئ العقد الخاص بك يمرر صراحة حزمة الهدف:
import type { ContractInput } from '@prisma/orm-mongo/contract-builder'; import mongoTargetPack from '@prisma/orm-mongo/target/pack'; const contract = mongoContract('./prisma/schema.prisma', { target: mongoTargetPack });
