skill

تطبيق محول Prisma Driver

مرجع مطلوب لعمل محول مشغل Prisma ORM 7 SQL. يستخدم عند تنفيذ أو تعديل المحولات، أو إضافة مشغلات قواعد البيانات، أو التعامل مع سلوك SqlDriverAdapter، Transaction، savepoint، تعيين النتائج، أو DriverAdapterError. يغطي دورة حياة المعاملات الحالية، وخطافات savepoint الاختيارية، والحفاظ على أخطاء قاعدة البيانات الأصلية، والتحقق.

prisma300,037+ تثبيتموثوق

نبذة

# تطبيق محول 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

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

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

أسئلة شائعة

ما هي مهارة تطبيق محول 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.

أصول ذات صلة

مختارات أخرى في البيانات والتحليلات.

كل بدائل تطبيق محول Prisma Driver ←
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
سجل Hyperframes
حوالي 450 كتلة ومكون HyperFrames جاهزة مثبتة كمصدر قابل للتعديل - انتقالات، تراكبات، عناوين، نصوص حركية، تسميات توضيحية، رسوم بيانية، تراكبات خرائط، ث…1,069,660+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
Microsoft Foundry
بناء ونشر وتقييم وتحسين وضبط وإدارة وكلاء ونماذج وموارد Microsoft Foundry من البداية إلى النهاية. يستخدم من أجل: foundry, azd ai agent, azd provision/…581,999+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
Azure Kusto
استعلام وتحليل البيانات في Azure Data Explorer (Kusto/ADX) باستخدام KQL لتحليلات السجلات، القياس عن بعد، وتحليل السلاسل الزمنية. متى: استعلامات KQL، ا…552,598+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
تخزين Azure
خدمات Azure Storage بما في ذلك Blob Storage وFile Shares وQueue Storage وTable Storage وData Lake. يجيب على الأسئلة المتعلقة بمستويات الوصول للتخزين (…546,701+
skillclaude_appclaude_codeclaude_api
npx skills add google/agents-cli
مراقبة واجهة سطر الأوامر لوكلاء Google
تستخدم هذه المهارة عندما يرغب المستخدم في "إعداد التتبع"، "مراقبة وكيله"، "تكوين التسجيل"، "إضافة قابلية المراقبة"، "تصحيح أخطاء حركة المرور في الإنتا…519,441+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الساحر
أنشئ معالج bash تفاعليا يرشد المستخدم البشري عبر خطوات لا يمكن إلا له تنفيذها. استخدمه عند توفير البنية التحتية، أو إعداد بيانات الاعتماد أو أسرار CI،…424,988+

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

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

المزيد في البيانات والتحليلات