skill
تطبيق محول Prisma Driver
مرجع مطلوب لعمل محول مشغل Prisma ORM 7 SQL. يستخدم عند تنفيذ أو تعديل المحولات، أو إضافة مشغلات قواعد البيانات، أو التعامل مع سلوك SqlDriverAdapter، Transaction، savepoint، تعيين النتائج، أو DriverAdapterError. يغطي دورة حياة المعاملات الحالية، وخطافات savepoint الاختيارية، والحفاظ على أخطاء قاعدة البيانات الأصلية، والتحقق.
نبذة
# تطبيق محول Prisma SQL Driver
استخدم هذا الدليل مع الإصدار الدقيق من `@prisma/driver-adapter-utils` المثبت بواسطة إصدار Prisma المستهدف. محولات Driver هي حدود بروتوكول: قد يؤدي الكود المتوافق مع النوع إلى إتلاف القيم، أو تسريب الاتصالات، أو كسر المعاملات.
## متى يتم التطبيق
- تنفيذ `SqlDriverAdapterFactory`، `SqlMigrationAwareDriverAdapterFactory`، `SqlDriverAdapter`، أو `Transaction` - إضافة دعم للمعاملات المتداخلة/نقاط الحفظ (savepoint) - تعيين قيم Driver، بيانات تعريف الأعمدة، وسائط الربط، أو أخطاء قاعدة البيانات - تصحيح أخطاء `P2039`، تسرب المعاملات، فشل قاعدة البيانات الظلية، أو سلوك الاستعلام الخاص بالمحول
## لقطة العقد
```typescript interface SqlDriverAdapterFactory extends AdapterInfo { connect(): Promise<SqlDriverAdapter> }
interface SqlMigrationAwareDriverAdapterFactory extends SqlDriverAdapterFactory { connectToShadowDb(): Promise<SqlDriverAdapter> }
interface SqlDriverAdapter extends AdapterInfo { queryRaw(query: SqlQuery): Promise<SqlResultSet> executeRaw(query: SqlQuery): Promise<number> executeScript(script: string): Promise<void> startTransaction(isolationLevel?: IsolationLevel): Promise<Transaction> getConnectionInfo?(): ConnectionInfo dispose(): Promise<void> }
interface Transaction extends AdapterInfo { readonly options: { usePhantomQuery: boolean } queryRaw(query: SqlQuery): Promise<SqlResultSet> executeRaw(query: SqlQuery): Promise<number> commit(): Promise<void> rollback(): Promise<void> createSavepoint?(name: string): Promise<void> rollbackToSavepoint?(name: string): Promise<void> releaseSavepoint?(name: string): Promise<void> } ```
يتضمن `IsolationLevel` حاليا `READ UNCOMMITTED`، `READ COMMITTED`، `REPEATABLE READ`، `SNAPSHOT`، و `SERIALIZABLE`؛ تحقق مما تدعمه قاعدة البيانات المحددة.
## قواعد الأولوية
| الأولوية | القاعدة | التأثير | |----------|----------|---------| | حرج | اتصال مخصص واحد لكل معاملة | يمنع التداخل والتسرب | | حرج | `commit`/`rollback` هي خطافات تنظيف دورة الحياة | يمنع تكرار COMMIT/ROLLBACK | | حرج | نقاط الحفظ (Savepoints) تعيش على `Transaction`، وليس العمق العام للمحول | يجعل النطاقات المتداخلة محلية للاتصال | | حرج | الحفاظ على رمز/رسالة خطأ قاعدة البيانات الأصلية | يتيح استرجاع `P2039` المفيد | | عال | تعيين الوسائط وبيانات تعريف النتائج بدقة | يمنع إتلاف القيمة الصامت | | عال | قواعد البيانات الظلية معزولة ويتم تنظيفها دائما | يجعل Migrate آمنا | | عال | التخلص من الموارد التي يمتلكها المحول فقط | يمنع إيقاف تجمعات الاتصال التي يمتلكها المتصل |
## تنفيذ الاستعلام
تحتوي `SqlQuery` على `sql`، `args`، و `argTypes` المتوازية. قم بتعيين كل وسيط باستخدام كل من القيمة و `ArgType`؛ لا تتجاهل معلومات النوع/العدد. نفذ في وضع صفوف المصفوفة/الزوج (array/tuple row mode) الخاص بال driver ليكون ترتيب الأعمدة مستقرا.
```typescript class ExampleQueryable { readonly provider = 'postgres' as const readonly adapterName = '@acme/adapter-example'
constructor(protected readonly connection: DriverConnection) {}
async queryRaw(query: SqlQuery): Promise<SqlResultSet> { try { const result = await this.connection.query({ text: query.sql, values: query.args.map((value, index) => mapArg(value, query.argTypes[index]), ), rowMode: 'array', })
return { columnNames: result.fields.map((field) => field.name), columnTypes: result.fields.map(mapColumnType), rows: result.rows, } } catch (error) { throwAdapterError(error) } }
async executeRaw(query: SqlQuery): Promise<number> { try { const result = await this.connection.execute( query.sql, query.args.map((value, index) => mapArg(value, query.argTypes[index])), ) return result.rowsAffected ?? 0 } catch (error) { throwAdapterError(error) } } } ```
### تعيين النتائج
أعد `columnNames`، `columnTypes`، و `rows` بأطوال/ترتيب متطابق. قم بتعيين بيانات تعريف ال driver إلى `ColumnTypeEnum` بشكل متعمد:
- عرض الأعداد الصحيحة الموقعة إلى `Int32`/`Int64`؛ حافظ على قيم 64-بت دون اقتطاع أرقام JS - عشري/رقمي إلى `Numeric` باستخدام التمثيل المتوقع بواسطة Prisma - ثنائي إلى `Uint8Array`/`Bytes` - التاريخ فقط، الوقت فقط، والطابع الزمني إلى `Date`، `Time`، و `DateTime` - UUID، JSON، التعداد، المصفوفات، والقيم غير المعروفة الخاصة بالمزود إلى أنواعها الصريحة - الأنواع الأصلية غير المدعومة إلى `DriverAdapterError({ kind: 'UnsupportedNativeDataType', type })`
اختبر `null`، المصفوفات الفارغة، أنواع عناصر المصفوفة، الأعداد الصحيحة الكبيرة، الأعداد العشرية، مصفوفات البايت، JSON، التواريخ، والأنواع الأصلية المعرفة من قبل المستخدم/غير المعروفة.
### تنفيذ السكريبت
يجب أن يقوم `executeScript` بتنفيذ سكريبت ترحيل (migration script) كما يتوقع المزود. فضل استخدام ميزة ال driver الأصلية للعبارات المتعددة/السكريبت أو محلل SQL حقيقي. التقسيم الساذج على `;` يكسر الدوال، المشغلات، السلاسل المقتبسة، والكتل الخاصة باللهجة.
## بروتوكول المعاملات
يجب أن يحصل `startTransaction` على اتصال مخصص واحد، ويبدأ معاملة قاعدة البيانات.
التثبيت
شغل هذا الأمر
npx skills add prisma/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add prisma/skills`، أو استنسخ المستودع وانسخ مجلد `prisma-driver-adapter-implementation` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة تطبيق محول Prisma Driver؟
مرجع مطلوب لعمل محول مشغل Prisma ORM 7 SQL. يستخدم عند تنفيذ أو تعديل المحولات، أو إضافة مشغلات قواعد البيانات، أو التعامل مع سلوك SqlDriverAdapter، Transaction، savepoint، تعيين النتائج، أو DriverAdapterError. يغطي دورة حياة المعاملات الحالية، وخطافات savepoint الاختيارية، والحفاظ على أخطاء قاعدة البيانات الأصلية، والتحقق.
كيف أثبت تطبيق محول Prisma Driver؟
شغل هذا الأمر في الطرفية:
npx skills add prisma/skillsمع أي أدوات ذكاء اصطناعي تعمل تطبيق محول Prisma Driver؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور تطبيق محول Prisma Driver؟
طورها prisma، وتصدر بترخيص MIT.
هل تطبيق محول Prisma Driver مجانية؟
نعم، يمكنك استخدامها مجانا وفق ترخيص MIT.
npx skills add heygen-com/hyperframes
npx skills add microsoft/azure-skills
npx skills add microsoft/azure-skills
npx skills add microsoft/azure-skills
npx skills add google/agents-cli
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى