تحليل إصدَار Prisma v8.0.0-rc.19

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

يمثل Prisma v8.0.0-rc.19 تطوراً معمارياً رئيسياً في كيفية تعامل موصل كائن البيانات (ORM) مع عقود البيانات، والتحقق من صحة مخطط البيانات، وخطوط تنفيذ وقت التشغيل. من خلال إعادة تحديد كيفية التعامل مع القيم الافتراضية بشكل جذري — عبر فصل قيود مستوى قاعدة البيانات عن القيم المُولّدة من جهة العميل باستخدام سمات @onCreate و @onUpdate — يُرسّخ هذا الإصدار فصلاً أوضح بين مخططات قاعدة البيانات وتنسيق طبقة التطبيق. علاوة على ذلك، فإن فرض كتابة قوية وصارمة على العقود عند التهيئة يلغي التخمين، مما يضمن أن تمثيلات وقت التشغيل تتوافق بدقة مع هياكل طبقة البيانات الأساسية.

من منظور تصميم الأنظمة، فإن تخزين كل قيمة افتراضية بشكل مملوك صراحةً لنوع بيانات عمودها يُبسط بشكل كبير إجراءات فك التشفير ويمنع أخطاء تحويل الأنواع الصامتة والدقيقة. ومن خلال دمج العلامات الأصلية (Native Tagging) للقيم الافتراضية الخاصة بالتاريخ، والوقت، والفترة الزمنية، والبايتات، تضمن Prisma دقة عالية عند التسلسل عبر حدود اللغات وبرامج تشغيل قواعد البيانات. تُقلل هذه التعديلات الهيكلية في النهاية من الحمل الزائد أثناء تخطيط الاستعلام وتنفيذه، مما يسمح لطبقات الوسيط (Middleware) والتخزين المؤقت بفحص أنشطة الـ ORM الفردية كوحدات متماسكة وذرية دون الاعتماد على اتصالات قاعدة البيانات النشطة.

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

تتلقى هندسة راحة المطورين دفعة كبيرة في الإصدار v8.0.0-rc.19 من خلال عمليات تحقق دلالية أكثر صرامة في لغة مخطط Prisma (PSL). تُقيّم وسائط مُنشئ الأنواع الآن بدلاً من ذلك كقيم حرفية بدلاً من السلاسل النصية غير المُحللة (على سبيل المثال، الانتقال من VarChar("255") إلى VarChar(255))، مما يمنع انحراف الإعدادات وتناقضات التحليل أثناء وقت التشغيل. بالإضافة إلى ذلك، تُفسَّر أعضاء التعدادات (Enums) الآن مباشرة كقيم مُعنوّنة (Typed) لترميزها الأساسي، مما يتيح دلالات مقارنة دقيقة حيث يتم التعرف على قيم مثل 0.5 و 0.50 بشكل صحيح كنسخ مكررة ضمن الأنواع الرقمية.

يتم توسيع المرونة بشكل أكبر من خلال تقديم إعلان Raw(sql...)، مما يسمح للمطورين باستهداف أنواع قواعد البيانات التعسفية بسلاسة إلى جانب استعادة تحميل مخطط Prisma 7 لحقول Unsupported(...). كما تم تحسين إنشاء العميل (Client Instantiation): فبدلاً من تمرير إعدادات عامة خام أو مضمنة مباشرة إلى دالة الموصل، يقوم المطورون الآن بإنشاء العقود صراحةً باستخدام contractFromJson<Contract>(contractJson) من نقطة الدخول الثابتة /static للواجهة. يوفر هذا ضمانات فائقة لأمان الأنواع ويجعل تتبع الأخطاء في وقت التشغيل أكثر شفافية.

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

التغييرات الجذرية وتنبيهات الترحيل

يُقدم Prisma v8.0.0-rc.19 العديد من التغييرات الجذرية التي تتطلب تحديثات منهجية عبر قاعدة الكود الخاصة بك مثيلات قاعدة البيانات الخاصة بك. مولدات العملاء المُعرّفة مسبقاً عبر @default(uuid())، و @default(nanoid())، وما شابه ذلك، يتم رفضها الآن بصرامة ويجب ترحيلها إلى @onCreate(...). وبالمثل، تم إهمال معدّل @noCheck تماماً لصالح دلالات قبول القيم الفارغة (Nullability) الأصلية للمصفوفات (مثل T?[])، مما يتطلب تحديثات فورية للعقود المخزنة ولقطات الترحيل.

تفرض مُنشئات الأنواع، وإعلانات التعدادات، والقيم الافتراضية للحقول الزمنية أو الثنائية قواعد كتابة صارمة. ستؤدي الأرقام المضمنة بين علامات اقتباس في مُنشئات الأنواع والسلاسل النصية غير المُعلّمة للتواريخ أو مصفوفات البايت (bytea باستخدام صيغة ست عشرية بدلاً من base64) إلى أخطاء في الترقية والترجمة. يجب على المطورين تنفيذ نصوص الترقية المتوفرة، وإعادة إصدار العقود، وتشغيل prisma db sign مقابل جميع قواعد البيانات المتصلة لتحديث التوقيعات التشفيرية.

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

اتبع هذه الخطوات العملية لترقية تطبيقك بأمان إلى الإصدار Prisma v8.0.0-rc.19:

1. تنفيذ نصوص الترقية الآلية: قم بتشغيل نصوص ترقية التطبيق أو الإضافة الرسمية المتوفرة في المستودع لإعادة كتابة ملفات PSL تلقائياً، وتحويل تهيئة العقد من جهة العميل، واستبدال بناء جملة @noCheck المُهمل بـ T?[].

2. تحديث كود تهيئة العميل: استبدل إعدادات contractJson المضمنة بنمط الإنشاء الثابت الجديد:

import { contractFromJson } from '@prisma/orm-postgres/static';
export const contract = contractFromJson<Contract>(contractJson);
export const db = postgres({ contract, url: process.env['DATABASE_URL']! });

3. توقيع والتحقق من قواعد البيانات: بعد تطبيق تعديلات المخطط وإعادة إصدار العقود، قم بتنفيذ أداة توقيع قاعدة البيانات لتحديث التجزئات (Hashes):

prisma contract emit
prisma db sign