skill

واجهة برمجة تطبيقات Prisma Client

مرجع Prisma Client API يغطي استعلامات النماذج، الفلاتر، المعاملات، وطرق العميل. يستخدم عند كتابة استعلامات قاعدة البيانات، استخدام عمليات CRUD، تصفية البيانات، أو تهيئة Prisma Client. يفعل عند "prisma query", "findMany", "create", "update", "delete", "$transaction".

prisma311,858+ تثبيتموثوق

نبذة

# مرجع Prisma Client API

مرجع API الكامل ل Prisma Client. توفر هذه المهارة إرشادات حول استعلامات النموذج، والتصفية، والعلاقات، وأساليب العميل لمشاريع Prisma الحالية.

## متى يتم التطبيق

ارجع إلى هذه المهارة عند: - كتابة استعلامات قاعدة البيانات باستخدام Prisma Client - إجراء عمليات CRUD (إنشاء، قراءة، تحديث، حذف) - تصفية البيانات وفرزها - العمل مع العلاقات - استخدام المعاملات (transactions) - تهيئة خيارات العميل

## فئات القواعد حسب الأولوية

| الأولوية | الفئة | التأثير | البادئة | |----------|----------|--------|--------| | 1 | Client Construction | عالي | `constructor` | | 2 | Model Queries | حرج | `model-queries` | | 3 | Query Shape | عالي | `query-options` | | 4 | Filtering | عالي | `filters` | | 5 | Relations | عالي | `relations` | | 6 | Transactions | حرج | `transactions` | | 7 | Raw SQL | حرج | `raw-queries` | | 8 | Client Methods | متوسط | `client-methods` |

## مرجع سريع

- `constructor` - إعداد `PrismaClient`، توصيل المحول، التسجيل، ومكونات تعليقات SQL الإضافية - `model-queries` - عمليات CRUD والعمليات المجمعة - `query-options` - `select`, `include`, `omit`, الفرز، الترحيل - `filters` - عوامل تصفية قياسية ومنطقية - `relations` - قراءات العلاقات والكتابات المتداخلة - `transactions` - أنماط المعاملات (transactions) المصفوفة والتفاعلية - `raw-queries` - سلامة `$queryRaw` و `$executeRaw` - `client-methods` - أساليب دورة الحياة، الإضافات، وأنماط `satisfies` ل `prisma-client`

## إنشاء مثيل العميل (Client Instantiation)

```typescript import { PrismaClient } from '../generated/client' import { PrismaPg } from '@prisma/adapter-pg'

const adapter = new PrismaPg({ connectionString: process.env.DATABASE_URL })

const prisma = new PrismaClient({ adapter }) ```

## أساليب استعلام النموذج (Model Query Methods)

| الأسلوب | الوصف | |--------|-------------| | `findUnique()` | البحث عن سجل واحد بواسطة حقل فريد | | `findUniqueOrThrow()` | البحث عن سجل واحد أو إلقاء خطأ | | `findFirst()` | البحث عن أول سجل مطابق | | `findFirstOrThrow()` | البحث عن أول سجل مطابق أو إلقاء خطأ | | `findMany()` | البحث عن سجلات متعددة | | `create()` | إنشاء سجل جديد | | `createMany()` | إنشاء سجلات متعددة | | `createManyAndReturn()` | إنشاء سجلات متعددة وإرجاعها | | `update()` | تحديث سجل واحد | | `updateMany()` | تحديث سجلات متعددة | | `updateManyAndReturn()` | تحديث سجلات متعددة وإرجاعها | | `upsert()` | تحديث أو إنشاء سجل | | `delete()` | حذف سجل واحد | | `deleteMany()` | حذف سجلات متعددة | | `count()` | عد السجلات المطابقة | | `aggregate()` | تجميع القيم (المجموع، المتوسط، إلخ.) | | `groupBy()` | تجميع وتجميع |

## خيارات الاستعلام (Query Options)

| الخيار | الوصف | |--------|-------------| | `where` | شروط التصفية | | `select` | الحقول المراد تضمينها | | `include` | العلاقات المراد تحميلها | | `omit` | الحقول المراد استبعادها | | `orderBy` | ترتيب الفرز | | `take` | تحديد عدد النتائج | | `skip` | تخطي النتائج (الترحيل) | | `cursor` | الترحيل المستند إلى المؤشر | | `distinct` | قيم فريدة فقط |

## أساليب العميل (Client Methods)

| الأسلوب | الوصف | |--------|-------------| | `$connect()` | الاتصال الصريح بقاعدة البيانات | | `$disconnect()` | قطع الاتصال بقاعدة البيانات | | `$transaction()` | تنفيذ معاملة | | `$queryRaw()` | تنفيذ استعلام SQL خام | | `$executeRaw()` | تنفيذ أمر SQL خام | | `$on()` | الاشتراك في الأحداث | | `$extends()` | إضافة إضافات |

## أمثلة سريعة

### البحث عن سجلات

```typescript // Find by unique field const user = await prisma.user.findUnique({ where: { email: 'alice@prisma.io' } })

// Find with filter const users = await prisma.user.findMany({ where: { role: 'ADMIN' }, orderBy: { createdAt: 'desc' }, take: 10 }) ```

### إنشاء سجلات

```typescript const user = await prisma.user.create({ data: { email: 'alice@prisma.io', name: 'Alice', posts: { create: { title: 'Hello World' } } }, include: { posts: true } }) ```

### تحديث سجلات

```typescript const user = await prisma.user.update({ where: { id: 1 }, data: { name: 'Alice Smith' } }) ```

### حذف سجلات

```typescript await prisma.user.delete({ where: { id: 1 } }) ```

### المعاملات (Transactions)

```typescript const [user, post] = await prisma.$transaction([ prisma.user.create({ data: { email: 'alice@prisma.io' } }), prisma.post.create({ data: { title: 'Hello', authorId: 1 } }) ]) ```

## ملفات القواعد

وثائق API مفصلة:

``` references/constructor.md - خيارات منشئ PrismaClient references/model-queries.md - عمليات CRUD references/query-options.md - select, include, omit, where, orderBy references/filters.md - شروط وعوامل التصفية references/relations.md - استعلامات العلاقات والعمليات المتداخلة references/transactions.md - واجهة برمجة تطبيقات المعاملات references/raw-queries.md - $queryRaw, $executeRaw references/client-methods.md - $connect, $disconnect, $on, $extends ```

## عوامل التصفية (Filter Operators)

| العامل | الوصف | |----------|-------------| | `equals` | تطابق تام | | `not` | لا يساوي |

التثبيت

شغل هذا الأمر

npx skills add prisma/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

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

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

أسئلة شائعة

ما هي مهارة واجهة برمجة تطبيقات Prisma Client؟

مرجع Prisma Client API يغطي استعلامات النماذج، الفلاتر، المعاملات، وطرق العميل. يستخدم عند كتابة استعلامات قاعدة البيانات، استخدام عمليات CRUD، تصفية البيانات، أو تهيئة Prisma Client. يفعل عند "prisma query", "findMany", "create", "update", "delete", "$transaction".

كيف أثبت واجهة برمجة تطبيقات Prisma Client؟

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

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

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

من طور واجهة برمجة تطبيقات Prisma Client؟

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

هل واجهة برمجة تطبيقات Prisma Client مجانية؟

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

أصول ذات صلة

مختارات أخرى في إنشاء المحتوى.

كل بدائل واجهة برمجة تطبيقات Prisma Client ←
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط مستندات النطاق. يتم تشغيله مرة واحدة قبل الاستخدام…1,076,003+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
بوابة Azure AI
تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة ال…605,853+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
تحقق من سؤال مقابل مصادر أولية موثوقة للغاية، وسجل النتائج كملف Markdown في المستودع. استخدم هذا عندما يريد المستخدم البحث في موضوع، أو جمع حقائق حول…576,164+

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

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

المزيد في إنشاء المحتوى