skill
واجهة برمجة تطبيقات Prisma Client
مرجع Prisma Client API يغطي استعلامات النماذج، الفلاتر، المعاملات، وطرق العميل. يستخدم عند كتابة استعلامات قاعدة البيانات، استخدام عمليات CRUD، تصفية البيانات، أو تهيئة Prisma Client. يفعل عند "prisma query", "findMany", "create", "update", "delete", "$transaction".
نبذة
# مرجع 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يعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add prisma/skills`، أو استنسخ المستودع وانسخ مجلد `prisma-client-api` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة واجهة برمجة تطبيقات 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.
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى