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

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

إلى جانب سلامة المعاملات، يعزز الإصدار 7.10.1 الوضع الأمني الأساسي لنظام Prisma البيئي. من خلال التدقيق والترقية القوية للتبعيات الانتقالية والنظيرة — بما في ذلك التصحيحات الحرجة لـ mysql2، و fast-uri، و deepmerge-ts، و source-map-js، ومشغل mariadb الأصلي — يخفف فريق الهندسة من نواقل سلاسل التوريد المحتملة. علاوة على ذلك، يقدم Prisma Migrate حواجز حماية دفاعية ضد عمليات حذف المخططات الكارثية الناتجة عن قواعد البيانات الوهمية التي تم تكوينها بشكل خاطئ. تؤكد هذه التحسينات على التزام Prisma بالموثوقية على مستوى المؤسسات، مما يوفر للمطورين تفاعلات متوقعة مع قواعد البيانات وأوضاع فشل قوية.

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

يحل الإصلاح المعماري الأبرز في Prisma 7.10.1 عيبا دقيقا في تحول المراجع في استدعاءات $transaction المتداخلة. سابقا، إذا أعاد المطور استخدام كائن خيارات تكوين ثابت (مثل { timeout: 30_000, maxWait: 10_000 }) عبر كل من المعاملات التفاعلية المتداخلة وتلك الموجودة على المستوى الأعلى، فإن المحرك الداخلي كان يقوم عن طريق الخطأ بحقن معرف المعاملة الخارجية مباشرة في ذلك الكائن المشترك. تم بعد ذلك الإشارة بشكل غير صحيح إلى المعاملات اللاحقة على المستوى الأعلى التي تشير إلى هذا الكائن المعدل على أنها عمليات متداخلة. اعتمادا على ما إذا كانت المعاملة التاريخية قد اكتملت، أدى ذلك إما إلى طرح خطأ معاملة P2028 أو تنفيذ استعلامات جديدة بصمت كنقاط حفظ داخل سياقات تنفيذ غير ذات صلة. يقضي Prisma Client 7.10.1 تماما على هذا الأثر الجانبي من خلال التعامل مع كائنات التكوين ككائنات غير قابلة للتغيير، مع الحفاظ على العزل المعاملي المطلق.

بالتوازي مع ذلك، يتناول Prisma Migrate مخاطر تكوين خاطئ حادة حيث يقوم المطورون عن غير قصد بتوجيه عنوان URL الخاص بقاعدة البيانات الوهمية مباشرة إلى قاعدة بيانات الإنتاج أو التطوير الأساسية الخاصة بهم. تاريخيا، يمكن أن يؤدي تشغيل العمليات مثل prisma migrate diff --from-migrations مع هذا الإعداد الخاطئ إلى مسح المخطط الحي وإعادة إنشائه من الصفر، مما ينتج عنه فرق هيكلي فارغ دون تحذير. يقدم الإصدار 7.10.1 الخطأ P3025، مما يتسبب في توقف محرك الترحيل عن التنفيذ فورا عند اكتشاف تصادم مؤشرات قاعدة البيانات الرئيسية والوهمية. بالإضافة إلى ذلك، تم رفع @prisma/adapter-mariadb إلى الإصدار 3.5.4، مما أدى إلى إزالة الحلول البديلة اليدوية لإعادة كتابة مضيف IPv6 لصالح دعم المشغل الأصلي مع حل إشعارات الأمان الأساسية بالكامل.

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

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

يتوافق Prisma 7.10.1 تماما مع الإصدارات السابقة 7.x ولا يقدم أي تغييرات جذرية مقصودة في واجهة برمجة التطبيقات لأنماط الاستعلام القياسية. ومع ذلك، فإن المطورين الذين يعتمدون على الآثار الجانبية غير الموثقة مسبقا — وتحديدا أولئك الذين اعتمدوا عن غير قصد على كائنات خيارات المعاملات المشتركة التي تحتفظ بمعرفات المعاملات — سيجدون أن تلوث الحالة لم يعد يحدث.

يعمل إدخال رمز الخطأ P3025 كغيير جذري صارم فقط لخطوط أنابيب CI/CD أو البيئات المحلية التي تم تكوينها بشكل غير صحيح لاستخدام قاعدة البيانات الأساسية كقاعدة بيانات وهمية أثناء عمليات الترحيل. إذا كانت نصوص نشرك أو إعداداتك المحلية تؤدي إلى تشغيل الخطأ P3025، فيجب عليك توفير مثيل قاعدة بيانات وهمية مخصص ومنعزل على الفور للتوافق مع عمليات التحقق من السلامة الخاصة بـ Prisma Migrate.

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

تتطلب الترقية إلى Prisma 7.10.1 تحديثات إدارة التبعيات القياسية إلى جانب التحقق السريع من تكوينات الترحيل الخاصة بك.

1. تحديث حزم Prisma: قم بترقية حزم Prisma CLI و Client إلى الإصدار 7.10.1 باستخدام مدير الحزم المفضل لديك:

   npm install [email protected] @prisma/[email protected] @prisma/adapter-mariadb@latest
   

2. التحقق من تكوين قاعدة البيانات الوهمية: تأكد من أن ملف .env أو تكوين مصدر البيانات الخاص بك يحتفظ بعناوين URL متميزة لقاعدة البيانات الأساسية وقاعدة البيانات الوهمية لمنع تشغيل حاجز الحماية الجديد P3025:

   datasource db {
     provider          = "postgresql"
     url               = env("DATABASE_URL")
     shadowDatabaseUrl = env("SHADOW_DATABASE_URL")
   }
   

3. التحقق من استخدام خيارات المعاملات: راجع قواعد التعليمات البرمجية حيث تتم مشاركة كائنات خيارات المعاملات الثابتة عبر حدود متعددة لـ $transaction. بينما يتعامل Prisma 7.10.1 مع هذه الكائنات بأمان الآن، فإن ضمان نطاق المتغيرات النظيف يعمل على تحسين قابلية الصيانة على المدى الطويل:

   const getTxOptions = () => ({ timeout: 30_000, maxWait: 10_000 });
   
   await prisma.$transaction(async (tx) => {
     await tx.$transaction(async (inner) => { /* ... */ }, getTxOptions());
   }, getTxOptions());