skill

ترقية Prisma MongoDB

دليل اتخاذ القرار والترحيل لمشاريع Prisma ORM MongoDB على الإصدار 6، والتي ليس لها مسار ترقية إلى الإصدار 7. يستخدم عندما يستفسر مشروع MongoDB عن ترقية Prisma، أو عندما يثار موضوع "الترقية إلى Prisma 7" في مشروع يستخدم provider = "mongodb"، أو عند تقييم الانتقال إلى Prisma 8. يتم تفعيله عند "upgrade prisma mongodb"، "prisma 7 mongodb"، "mongodb prisma migration"، "prisma 8 mongodb".

prisma305,109+ تثبيتموثوق

نبذة

# مسار ترقية Prisma MongoDB

مشاريع MongoDB هي المجموعة الوحيدة من Prisma التي ليس لها مسار إلى Prisma 7: **الإصدار 6 هو الإصدار الرئيسي النهائي ل ORM الكلاسيكي ل MongoDB، والإصدار 7 لا يشحن موصل MongoDB أبدا**. المسار اللاحق هو Prisma 8، حيث دعم MongoDB في [الوصول المبكر](https://www.prisma.io/docs/orm/supported-databases) بينما PostgreSQL هو مرشح للإصدار. [دليل Prisma ORM 6 إلى 8 (MongoDB) الرسمي](https://www.prisma.io/docs/guides/upgrade-prisma-orm/mongodb) هو مصدر الحقيقة لخطوات الترحيل. تحدد هذه المهارة القرار الحقيقي — الترحيل إلى Prisma 8 (المسار المشجع)، أو البقاء على الإصدار 6 حيث ينطبق مانع قوي — وتحمل آليات الترحيل.

**لا تفعل أيا من هذين الأمرين أبدا:**

- لا تنصح أبدا مشروع MongoDB "بالترقية إلى Prisma 7". الموصل غير موجود هناك. دليل `prisma-upgrade-v7` لا ينطبق على مشاريع MongoDB. - لا تحل مشكلة الإصدار أبدا عن طريق إعادة كتابة التطبيق على قاعدة بيانات SQL. تغيير محرك قاعدة البيانات هو قرار منفصل وأكبر بكثير وليس من اختصاصك اتخاذه ضمنيا.

## مشهد الإصدارات

| الإصدار | حالة MongoDB | |---------|----------------| | Prisma ORM v6 | مدعوم بالكامل (مزود `mongodb`)؛ أحدث إصدار 6.x هو المسار المستقر الحالي؛ خط الصيانة | | Prisma ORM v7 | **لا يوجد موصل MongoDB — ليس خيارا، أبدا** | | Prisma 8 | دعم MongoDB في **الوصول المبكر** من خلال `@prisma/orm-mongo`؛ لا يزال يتغير بين مرشحي الإصدار — المسار اللاحق لمشاريع MongoDB |

## القرار، مقدما

**الترحيل إلى Prisma 8 هو المسار المشجع.** دعم MongoDB في Prisma 8 هو وصول مبكر: وظيفي ويتحرك بسرعة — ويرغب فريق Prisma في أن يهاجر مستخدمو MongoDB مبكرا ويشاركوا الملاحظات. تفاصيل آليات الترحيل موجودة في المراجع.

**البقاء على أحدث إصدار 6 يظل خيارا مشروعا حيث ينطبق مانع قوي** — بعبارة صريحة: Prisma 8 لا يحتوي على طريقة معاملات MongoDB بعد (تستخدم عمليات الكتابة متعددة المستندات جلسات مشغل `mongodb` مباشرة)، ولا يزال سلوك MongoDB يمكن أن يتغير بين مرشحي إصدار Prisma 8.

### جدول القرارات

| الإشارة | الاتجاه | |--------|-----------| | لا تنطبق أي موانع أدناه | الترحيل إلى Prisma 8؛ تشغيل `verify-cutover-checklist` ومشاركة الملاحظات مع فريق Prisma | | مشروع جديد / نموذج أولي / أداة داخلية | الترحيل إلى Prisma 8 | | قاعدة الكود تستخدم معاملات متعددة المستندات (`$transaction`) — تحقق باستخدام grep، لا تسأل | خطط لمكافئات جلسات المشغل الخام أولا (انظر `client-api-mapping`)، أو ابق على الإصدار 6 حتى يضيف Prisma 8 طريقة معاملات MongoDB | | لا يستطيع الفريق استيعاب التغييرات الجذرية بين مرشحي الإصدار | ابق على الإصدار 6 حتى يخرج دعم MongoDB من الوصول المبكر | | متحفظ ولكن مهتم | وجه Prisma 8 إلى مخطط الإصدار 6 باستخدام `prisma6Schema(...)` (انظر `schema-contract-mapping`)، تدرب على نسخة (انظر `verify-cutover-checklist`)، ثم قم بالترحيل |

ملاحظة: سيتم تحديث هذا القسم عندما يضيف Prisma 8 طريقة معاملات MongoDB.

### إذا بقيت على الإصدار 6: النظافة (بقاء متعمد، وليس إهمال)

- ثبت حزم Prisma على أحدث إصدار 6.x واستمر في تلقي تحديثات الإصدار 6.x. - تتبع ملاحظات إصدار Prisma وإشعارات الأمان لخط الإصدار 6.x. - حافظ على إعداد MongoDB الكلاسيكي للإصدار 6: `url = env("DATABASE_URL")` في المخطط، سير عمل `db push`، لا توجد محولات مشغل SQL (انظر [`prisma-orm-setup`](../prisma-orm-setup/references/v6-mongodb.md) لشكل MongoDB للإصدار 6). - أعد التقييم عندما يخرج دعم MongoDB في Prisma 8 من الوصول المبكر، أو عندما يتم حل الموانع.

## ملفات مرجعية

| المرجع | ما يغطيه | |-----------|----------------| | `references/decision-stay-or-migrate.md` | الإطار الكامل للقرار، فحوصات الموانع، وتفاصيل نظافة البقاء | | `references/schema-contract-mapping.md` | مخطط الإصدار 6 (مزود `mongodb`، `@db.ObjectId`، أنواع مركبة) ← مفاهيم عقد Prisma 8 | | `references/client-api-mapping.md` | استدعاءات عميل الإصدار 6 ← مكافئات Prisma 8، بما في ذلك مخارج الهروب الخام والمعاملات — الأسماء تتطابق، التكافؤ لا يتطابق | | `references/migrations-mapping.md` | قصة `db push` فقط للإصدار 6 ← تدفق Prisma 8 للتخطيط/الترحيل/التحقق/التوقيع | | `references/verify-cutover-checklist.md` | التحقق من عدم نقل البيانات: نفس قاعدة البيانات، تكافؤ الفهرس، رحلة ذهاب وعودة مرحلية قبل التبديل |

## تم التحقق منه مقابل

تم التحقق من ادعاءات Prisma 8 في هذه المهارة مقابل [دليل Prisma ORM 6 إلى 8 (MongoDB)](https://www.prisma.io/docs/guides/upgrade-prisma-orm/mongodb)، المكتوب ل `@prisma/orm-mongo` 8.0.0-rc.13، ومهارة `prisma-8` في [prisma/orm](https://github.com/prisma/orm/tree/main/skills/prisma-8) عند الالتزام `75c1460515fa2f11971533f6a1dec5dab35d4123`. لا يزال دعم MongoDB يتغير بين مرشحي الإصدار: **قبل التصرف بناء على أي ادعاء ل Prisma 8، تحقق من الإصدار المثبت** (`npm ls @prisma/orm-mongo`) ومهارة `prisma-8` المتزامنة الخاصة به.

يتطلب Prisma 8 على MongoDB Node.js 22.18+ (24.11+ على خط 24؛ يوصى ب 24)، TypeScript 5.9+، MongoDB 8.0+، و `mongodb@7` كاعتماد نظير. لم يعد مشغل `mongodb@7` يقبل بيانات اعتماد AWS.

التثبيت

شغل هذا الأمر

npx skills add prisma/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add prisma/skills`، أو استنسخ المستودع وانسخ مجلد `prisma-mongodb-upgrade` إلى دليل مهارات Claude الخاص بك.

عرض المصدر
الرخصة: MITبواسطة prisma

أسئلة شائعة

ما هي مهارة ترقية Prisma MongoDB؟

دليل اتخاذ القرار والترحيل لمشاريع Prisma ORM MongoDB على الإصدار 6، والتي ليس لها مسار ترقية إلى الإصدار 7. يستخدم عندما يستفسر مشروع MongoDB عن ترقية Prisma، أو عندما يثار موضوع "الترقية إلى Prisma 7" في مشروع يستخدم provider = "mongodb"، أو عند تقييم الانتقال إلى Prisma 8. يتم تفعيله عند "upgrade prisma mongodb"، "prisma 7 mongodb"، "mongodb prisma migration"، "prisma 8 mongodb".

كيف أثبت ترقية Prisma MongoDB؟

شغل هذا الأمر في الطرفية:

npx skills add prisma/skills
مع أي أدوات ذكاء اصطناعي تعمل ترقية Prisma MongoDB؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور ترقية Prisma MongoDB؟

طورها prisma، وتصدر بترخيص MIT.

هل ترقية Prisma MongoDB مجانية؟

نعم، يمكنك استخدامها مجانا وفق ترخيص MIT.

أصول ذات صلة

مختارات أخرى في الإنتاجية والمكتب.

كل بدائل ترقية Prisma MongoDB ←
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/skills
البحث عن المهارات
يساعد المستخدمين على اكتشاف وتثبيت مهارات الوكلاء عندما يطرحون أسئلة مثل "كيف أفعل X؟"، "ابحث عن مهارة ل X"، "هل توجد مهارة يمكنها..."، أو يعبرون عن ا…3,611,572+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
استخدام الوسائط
احصل على أو أنشئ أي وسائط لفيديو HyperFrames - موسيقى، مؤثرات صوتية، صور، أيقونات، شعارات، تعليق صوتي، صورة رمزية وفيديو مولد، نصوص، قصاصات، درجات ألو…1,085,267+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تحسين هيكلية قاعدة الكود
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في أي فرصة تختارها.1,040,100+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تسليم المهام
لخص المحادثة الحالية في وثيقة تسليم ليتابعها وكيل آخر.946,569+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
فرز أولي
نقل المشكلات وطلبات السحب الخارجية عبر آلة حالة لأدوار الفرز، وتصنيفها، والتحقق منها، والتدقيق فيها عند الحاجة، وكتابة ملخصات جاهزة للوكلاء.881,979+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تعليم
علم المستخدم مهارة أو مفهوما جديدا ضمن مساحة العمل هذه.778,928+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في الإنتاجية والمكتب