نمای کلی اجرایی و اهمیت معماری
نسخه v8.0.0-rc.21 پریزوما گامی به جلو و بزرگ در چرخه انتشار نسخه 8 است که بهبودهای حیاتی معماری را در پایگاههای داده رابطهای، مونگودب و مدیریت خطای سمت کلاینت معرفی میکند. از آنجا که جریانهای کاری پایگاه داده سازمانی روز به روز پیچیدهتر میشوند، حفظ همسویی دقیق قرارداد بین تعاریف طرحواره، اجراکنندگان مهاجرت و رفتار زمان اجرا اهمیتژرفی مییابد. این نسخه به ثبات پایگاه میپردازد و اطمینان حاصل میکند که پستگرسکیوال، اسکیلایت و مونگودب تحت خطوط لوله اعتبارسنجی یکپارچه عمل کنند و در عین حال قابلیت پیشبینی در انتشار خطای ناهمگام را تقویت میکنند.
از منظر معماری، نسخه v8.0.0-rc.21 نحوه ارزیابی، ساخت و تأیید قراردادهای ذخیرهسازی را استانداردسازی میکند. با حذف مسیرهای اجرای اضافی در تجزیه قرارداد مونگودب—که ورودیهای تایپاسکریپت، PSL و پریزوما 6 را به یک سازنده قوی واحد تبدیل میکند—پریزوما مغایرتهای موارد لبه را به طور قابل توجهی کاهش میدهد. علاوه بر این، بازنگری برنامهریزی مهاجرت برای تغییرات شمارشی در پستگرسکیوال و اسکیلایت، تکامل طرحواره رابطهای را با انتظارات صنعت هماهنگ میکند. به جای شکست خاموش یا نیاز به بازنشانی مخرب پایگاه داده، رابط خط فرمان اکنون بررسیهای ایمنی تعاملی ساختاریافته و مسیرهای بازیابی صریح را برای حالتهای قرارداد خارج از محدوده فراهم میکند.
بهبودهای اصلی و ارگونومی توسعهدهنده
ارگونومی توسعهدهنده با ورود اولین بستههای برنامهریزی و کاربرد مهاجرت عمومی مایاسکیال تقویت قابل توجهی دریافت میکند و برابری ویژگیها را در سراسر پایگاههای داده رابطهای اصلی پریزوما به ارمغان میآورد. کاربران پستگرسکیوال و اسکیلایت نیز از مدیریت پیشرفته چرخه حیات شمارشی بهرهمند میشوند؛ عملیاتهایی مانند migration plan و db update اکنون میتوانند مقادیر شمارشی را به طور یکپارچه تغییر نام دهند یا حذف کنند در حالی که به طور خودکار ردیفهای وابسته را بازنویسی میکنند. انواع تاریخ و زمان در پستگرسکیوال به صراحت بازنویسی شدهاند تا ماهیت دقیق مقادیری را که میخوانند به روشنی مشخص کنند و استانداردهای اعتبارسنجی سختگیرانه ISO 8601 را به طور یکنواخت در تمام سرورها اجرا کنند.
در اکوسیستم مونگودب، قوانین ارزیابی قرارداد به شدت استانداردسازی شدهاند. چه تعریف طرحوارهها از طریق تایپاسکریپت، PSL یا قالبهای قدیمی پریزوما 6 باشد، هر منبع اکنون از یک موتور اعتبارسنجی واحد عبور میکند. این امر قوانین چندریختی سختگیرانهای را اعمال میکند—مانند الزام اینکه تفکیککنندهها فیلدهای غیرالزامی و مبتنی بر متن باشند—و تعاریف شاخص تکراری را به طور خودکار حذف میکند. علاوه بر این، پیشفرضهای فیلد به نفع سازندگان نوع صریح و نامهای مستعار نوع منسوخ شدهاند که مدل ذهنی را برای ترکیب طرحواره سادهسازی کرده و ایمنی نوع کلی را در دامنههای برنامههای پیچیده بهبود میبخشد.
ماتریس مقایسه معماری
| ویژگی / معیار | مبنای قبلی (پیشانتشار v8.0.x) | پریزوما v8.0.0-rc.21 | تأثیر معماری |
|---|---|---|---|
| تأخیر خطای کلاینت | پرتاب همگام آنی در هنگام فراخوانی | رد Promise/Result پس از انتظار/خوانش | خطاهای اجرای همگام مدیریتنشده را حذف میکند؛ به طور تمیز با Promise.allSettled یکپارچه میشود. |
| سازندگان قرارداد مونگودب | تجزیهکنندههای تکهتکه در TS و PSL | خط لوله سازنده یکپارچه | قوانین اعتبارسنجی یکسان را صرف نظر از قالب ورودی طرحواره تضمین میکند. |
| تغییر شمارشی (PG/SQLite) | مقادیر مدیریتنشده را نادیده گرفته یا شکست داد | اعلان تعاملی یا پرچمهای صریح CLI (--rename/--delete) |
از خرابی دادههای خاموش جلوگیری کرده و تبدیل دادههای سطح ردیف را خودکار میکند. |
| پشتیبانی مهاجرت MySQL | آزمایشی / فقط داخلی | اولین بستههای مهاجرت عمومی و پایدار | برابری کامل تولید را برای مدیریت چرخه حیات پایگاه داده MySQL ایجاد میکند. |
تغییرات اساسی و هشدارهای مهاجرت
پریزوما v8.0.0-rc.21 چندین تغییر اساسی عمدی را معرفی میکند که برای سختتر کردن قابلیت پیشبینی زمان اجرا طراحی شدهاند. به طور قابل توجهی، اعضای کلاینت در نمونههای postgres(), sqlite() و supabase() مرتبط با نقش، اکنون به جای پرتاب همگام هنگام فراخوانی روی یک کلاینت بسته، اتصال ناموفق یا تراکنش خاتمهیافته، یک promise یا نتیجه ردشده برمیگردانند. در نتیجه، بلوکهای try/catch قدیمی اطراف فراخوانیهای ناهمگام پایگاه داده بدون یک await صریح، در گرفتن خطاهای اتصال شکست خواهند خورد؛ توسعهدهندگان باید اطمینان حاصل کنند که فراخوانیها به درستی منتظر ماندهاند.
علاوه بر این، قراردادهای مونگودب به تنظیمات بسته هدف صریح (mongoContract(path, { target })) نیاز دارند و چرخههای حیات اتصال پایگاه داده از استخرهای اتصال خارجی جدا شدهاند. فراخوانی close() روی یک کلاینت پریزوما اکنون زمان اجرای داخلی آن را حتی اگر یک pg.Pool خارجی فراهم شده باشد، به شدت خاتمه میدهد. در نهایت، هشهای طرحواره برای تنظیمات پریزوما 6 حاوی شاخصهای تکراری پس از انتشار تغییر خواهند کرد و نیاز به یک عملیات امضای ثانویه دارند.
راهنمای ارتقای گامبهگام
ارتقا به نسخه v8.0.0-rc.21 نیازمند اعتبارسنجی دقیق روالهای مدیریت خطای ناهمگام و تنظیمات قرارداد بهروزرسانیشده است. برای انتقال موفقیتآمیز این مراحل را دنبال کنید:
بهروزرسانی وابستگیها و اجرای مجدد انتشار قرارداد: بستههای پریزوما خود را به
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); }بهروزرسانی تعارف قرارداد مونگودب: اگر از مونگودب استفاده میکنید، اطمینان حاصل کنید که فراخوانی سازنده قرارداد شما بسته هدف را به صراحت منتقل میکند:
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 });
