نظرة عامة تنفيذية والأهمية المعمارية

يمثل إصدار Prisma v8.0.0-rc.20 محطة تطورية مهمة لسلسلة أدوات Prisma ORM، حيث يقدم تحسينات معمارية بالغة الأهمية عبر محرك واجهة سطر الأوامر (CLI)، لغة مخطط Prisma (PSL)، والأنظمة الفرعية للترحيل العلائقي. في صميم هذا الإصدار يكمن تبني @prisma/cli-engine 0.9.0، والذي يفصل بشكل جذري مخرجات الطرفية القابلة للقراءة بشرياً عن تدفقات JSON القابلة للقراءة آلياً. من خلال توجيه سجلات المستخدمين حصرياً إلى stderr وتخصيص stdout لأسطر البيانات النظيفة المفصولة بعلامات تبدو واضحة (ما لم يتم تجاوز ذلك صراحةً عبر علامة --json)، تفرض هذه الإصدار عقداً أكثر موثوقية وقابلية للتوقع لأنابيب التكامل المستمر (CI) الآلية، وscripts الصدفة، والوكلاء البرمجيين.

إلى جانب مرونة سطر الأوامر، يعالج هذا الإصدار مخاوف هيكلية عميقة تتعلق باستمرارية العقود، ودقة حل الأنواع، وفرض سلامة الأنواع. من خلال نقل تمثيل الأسماء المستعارة للأنواع مباشرة إلى تعريفات الأعمدة داخل العقد وبناة SQL، تضمن Prisma أن تحافظ تجزئات التخزين وعقود المخططات على تطابق تام مع هياكل قواعد البيانات الأساسية. تعمل هذه التعديلات النظامية على القضاء على أعطال وقت التشغيل الكامنة عن طريق دفع عدم تطابق العقود المحتمل وإغفال الأعمدة المفقودة مباشرة إلى أخطاء أنواع وقت الترجمة. ونتيجة لذلك، تستفيد البنى المؤسسية التي تعتمد على توليد المخططات الآلية، وأنابيب الترحيل المعقدة، وامتدادات قواعد البيانات المتعددة من ضمانات حتمية معززة.

التحسينات الأساسية ومرونة المطورين

تحظى مرونة المطورين بدفع قوي من خلال التحسينات في نمذجة المخططات وسلامة توليد SQL. في لغة PSL، يمكن للأسماء المستعارة للأنواع الآن إدارة خطافات @default و @onCreate و @onUpdate بسلاسة، مما يماثل طريقة إعلان خصائص الأعمدة المتخصصة. بدلاً من الاحتفاظ بمؤشرات الأسماء المستعارة الوسيطة في طبقات التخزين، يقوم معماري العقود الآن بتسلسل معاملات الترميز الأساسية (codecs) مباشرة. هذا يبسط بناء جملة منشئ مخطط TypeScript، مستبدلاً قواميس types المرهقة والتغليف مثل field.namedType(...) بتعيينات ثابتة مباشرة باستخدام field.column(...).

على جبهة عمليات قواعد البيانات، تم تعزيز منشئ استعلامات SQL بفحوصات أمان صارمة في وقت الترجمة. على وجه التحديد، يؤدي استدعاء db.sql.<namespace>.<table>.insert(rows) الآن إلى التحقق بدقة من أن كل عمود غير قابل للقيم الفارغة (non-nullable) ويفتقر إلى قيمة افتراضية يتم ملؤه صراحةً. سابقاً، كان إغفال مثل هذه السمكة المطلوبة ينجح في الترجمة فقط يفشل بشكل غير متوقع عند الوصول إلى برنامج تشغيل قاعدة البيانات. من خلال اكتشاف هذه الإغفالات أثناء التحقق الثاتي من الأنواع وإبراز أسماء الأعمدة الدقيقة، تقلل Prisma بشكل كبير من دورات تصحيح الأخطاء. ينطبق تشديد مماثل الآن على أعضاء تعداد MongoDB والمميزات (discriminators)، مما يضمن التزام القيم بدقة بترميز البيانات الأصلية الأساسية دون إكراه مبهم للأنواع.

مصفوفة المقارنة المعمارية

التغييرات الكاسرة ومحاذير الترحيل

يقدم إصدار Prisma v8.0.0-rc.20 العديد من التغييرات الكاسرة التي تتطلب سير عمل ترحيل متعمد لكل من التطبيقات والامتدادات. أولاً، يعني تحول الاعتمادية إلى @prisma/cli-engine 0.9.0 أن أي برنامج نصي يعتمد على مخرجات JSON الضمنية من أوامر مثل prisma migration status يجب تحديثه لتضمين علامة --json صراحة. ثانياً، ستفشل العقود المخزنة التي تستخدم مراجع أسماء مستعارة أقدم في التحميل بسبب تغير تجزئات التخزين. يجب على المطورين تنفيذ برامج نصية ترقية آلية لإعادة كتابة العقود المخزنة ولقطات الترحيل قبل إعادة إصدار العقود وتوقيع قواعد البيانات عبر prisma db sign.

بالإضافة إلى ذلك، تحكم قواعد التحقق الصارمة الآن عمليات إدخال SQL وتعريفات مخططات MongoDB. يؤدي إغفال الأعمدة غير القابلة للقيم الفارغة بدون قيم افتراضية إلى أخطاء في الترجمة، وسيتم رفض بناء جملة تعداد MongoDB القديم الذي يستخدم قيمًا كسرية لأنواع الأعداد الصحيحة أو حقول النصوص غير المقتبسة مع رموز خطأ صريحة (PSL_VALUE_TYPE_INCOMPATIBLE أو PSL_VALUE_REFUSED).

دليل الترقية خطوة بخطوة

1. تحديث تبعيات والنصوص البرمجية لـ CLI: قم ترقية تبعيات محرك واجهة سطر الأوامر في مشروعك إلى الإصدار 0.9.0 وأرفق --json بجميع الأوامر البرمجية التي تقرأ مخرجات منظمة.

# تحديث برامج CI النصية التي تتوقع مخرجات JSON
prisma migration status --json | jq '.envelope.result'

2. إعادة كتابة العقود وإعادة توقيع قواعد البيانات: قم بتشغيل برنامج الترقية الرسمي للتطبيق أو الامتداد لتطهير مراجع الأسماء المستعارة القديمة للأنواع من عقودك المخزنة ولقطات الترحيل، ثم قم بإعادة الإصدار والتوقيع.

# تنفيذ إصدار العقود وتوقيع قاعدة البيانات
prisma contract emit
prisma db sign --all

3. إعادة هيكلة بناة مخطط TypeScript: استبدل كائنات قواميس types القديمة ومغلفات field.namedType بتعليقات ثوابت الأعمدة المباشرة.

// بعد الترقية: تحديد الأعمدة مباشرة
const Embedding1536 = field.column(type.pgvector.Vector(1536));
const Post = model('Post', {
  fields: { embedding: Embedding1536.optional() },
});
export default { models: { Post } };