Maison
prisma-client-api
prisma/skills
Référence de l'API Prisma Client couvrant les requêtes de modèle, les filtres, les opérateurs et les méthodes client. À utiliser lors de la rédaction de requêtes de base de données, de l'utilisation d'opérations CRUD, du filtrage de données ou de la configuration de Prisma Client. Déclencheurs sur « prisma query », « findMany », « create », « update », « delete » et « $transaction ».
...Développer toutÀ propos de «prisma-client-api »
La compétence « prisma-client-api » fournit une référence complète pour interagir avec des bases de données à l’aide de Prisma Client. Elle simplifie le processus de création de requêtes, d’exécution d’opérations CRUD, d’application de filtres, de gestion des relations et de traitement des transactions au sein des projets Prisma. En proposant des conseils détaillés sur l’instanciation du client, les requêtes de modèle, les options de requête et l’exécution de SQL brut, cette compétence aide les développeurs à réduire les erreurs et à gagner en efficacité lorsqu’ils travaillent avec des bases de données relationnelles. Elle est particulièrement utile pour s’assurer que les requêtes sont correctement structurées et que les opérations avancées, telles que les écritures imbriquées et les transactions, sont gérées de manière sûre et efficace.
Cette compétence couvre un large éventail de fonctionnalités, notamment les méthodes de requête sur les modèles telles que `findUnique`, `findMany`, `create`, `update`, `delete`, `upsert`, ainsi que les fonctions d’agrégation comme `count`, `aggregate` et `groupBy`. Elle offre également une prise en charge étendue des options de requête, permettant aux développeurs de filtrer, sélectionner, inclure, omettre, trier, paginer et imposer des valeurs distinctes. Les méthodes Prisma Client pour la gestion du cycle de vie, les abonnements aux événements, l’exécution de requêtes SQL brutes et les extensions client sont également incluses. Cette compétence garantit l’exécution sécurisée des requêtes SQL brutes et fournit des conseils sur l’utilisation des transactions, tant basées sur des tableaux qu’interactives, afin de préserver l’intégrité des données.
Les utilisateurs cibles sont les développeurs backend, les administrateurs de bases de données et les ingénieurs full-stack travaillant avec JavaScript ou TypeScript qui ont besoin d’interagir efficacement avec des bases de données via Prisma. Les cas d’utilisation typiques concernent le développement d’applications web, d’API et de microservices où la précision de la récupération, de la manipulation et de l’agrégation des données est essentielle. Cette certification convient également aux équipes qui ont besoin d’une référence standard pour des modèles de requêtes cohérents et des bonnes pratiques lors de la mise en œuvre d’une logique relationnelle complexe ou de l’exécution d’opérations par lots dans des environnements de production.
FAQ
Comment instancier un Prisma Client avec un adaptateur personnalisé ?
Vous pouvez instancier Prisma Client en important PrismaClient et votre adaptateur, puis en transmettant la configuration de l’adaptateur au constructeur du client, comme le montre l’exemple TypeScript fourni.
Quelles opérations de base de données sont prises en charge par Prisma Client ?
Prisma Client prend en charge l’ensemble des opérations CRUD, notamment findUnique, findMany, create, createMany, update, updateMany, upsert, delete et deleteMany. Il prend également en charge les méthodes d’agrégation et de regroupement.
Prisma Client prend-il en charge les transactions ?
Oui, Prisma Client prend en charge à la fois les transactions basées sur des tableaux et les transactions interactives à l’aide de la méthode $transaction, ce qui permet d’exécuter plusieurs requêtes en toute sécurité au sein d’une seule transaction.
Le SQL brut est-il pris en charge et son utilisation est-elle sûre ?
Prisma Client fournit les méthodes $queryRaw et $executeRaw pour exécuter des requêtes SQL brutes. Celles-ci doivent être utilisées avec prudence afin d’éviter toute injection SQL, et la documentation fournit des conseils pour une utilisation en toute sécurité.
Quelles sont les conditions requises pour utiliser cette compétence API Prisma Client ?
Vous devez disposer d’un projet Prisma avec un client généré, d’une base de données prise en charge et d’un adaptateur approprié. Des environnements TypeScript ou JavaScript sont requis pour l’instanciation du client et l’exécution des requêtes.
Prisma Client API Reference
Complete API reference for Prisma Client. This skill provides guidance on model queries, filtering, relations, and client methods for current Prisma projects.
When to Apply
Reference this skill when:
- Writing database queries with Prisma Client
- Performing CRUD operations (create, read, update, delete)
- Filtering and sorting data
- Working with relations
- Using transactions
- Configuring client options
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Client Construction | HIGH | constructor |
| 2 | Model Queries | CRITICAL | model-queries |
| 3 | Query Shape | HIGH | query-options |
| 4 | Filtering | HIGH | filters |
| 5 | Relations | HIGH | relations |
| 6 | Transactions | CRITICAL | transactions |
| 7 | Raw SQL | CRITICAL | raw-queries |
| 8 | Client Methods | MEDIUM | client-methods |
Quick Reference
constructor-PrismaClientsetup, adapter wiring, logging, and SQL commenter pluginsmodel-queries- CRUD operations and bulk operationsquery-options-select,include,omit, sort, paginationfilters- scalar and logical filter operatorsrelations- relation reads and nested writestransactions- array and interactive transaction patternsraw-queries-$queryRawand$executeRawsafetyclient-methods- lifecycle methods, extensions, andsatisfiespatterns forprisma-client
Client Instantiation
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
| Method | Description |
|---|---|
findUnique() | Find one record by unique field |
findUniqueOrThrow() | Find one or throw error |
findFirst() | Find first matching record |
findFirstOrThrow() | Find first or throw error |
findMany() | Find multiple records |
create() | Create a new record |
createMany() | Create multiple records |
createManyAndReturn() | Create multiple and return them |
update() | Update one record |
updateMany() | Update multiple records |
updateManyAndReturn() | Update multiple and return them |
upsert() | Update or create record |
delete() | Delete one record |
deleteMany() | Delete multiple records |
count() | Count matching records |
aggregate() | Aggregate values (sum, avg, etc.) |
groupBy() | Group and aggregate |
Query Options
| Option | Description |
|---|---|
where | Filter conditions |
select | Fields to include |
include | Relations to load |
omit | Fields to exclude |
orderBy | Sort order |
take | Limit results |
skip | Skip results (pagination) |
cursor | Cursor-based pagination |
distinct | Unique values only |
Client Methods
| Method | Description |
|---|---|
$connect() | Explicitly connect to database |
$disconnect() | Disconnect from database |
$transaction() | Execute transaction |
$queryRaw() | Execute raw SQL query |
$executeRaw() | Execute raw SQL command |
$on() | Subscribe to events |
$extends() | Add extensions |
Quick Examples
Find records
// Find by unique fieldconst user = await prisma.user.findUnique({ where: { email: '[email protected]' }})// Find with filterconst users = await prisma.user.findMany({ where: { role: 'ADMIN' }, orderBy: { createdAt: 'desc' }, take: 10})
Create records
const user = await prisma.user.create({ data: { email: '[email protected]', name: 'Alice', posts: { create: { title: 'Hello World' } } }, include: { posts: true }})
Update records
const user = await prisma.user.update({ where: { id: 1 }, data: { name: 'Alice Smith' }})
Delete records
await prisma.user.delete({ where: { id: 1 }})
Transactions
const [user, post] = await prisma.$transaction([ prisma.user.create({ data: { email: '[email protected]' } }), prisma.post.create({ data: { title: 'Hello', authorId: 1 } })])
Rule Files
Detailed API documentation:
references/constructor.md - PrismaClient constructor optionsreferences/model-queries.md - CRUD operationsreferences/query-options.md - select, include, omit, where, orderByreferences/filters.md - Filter conditions and operatorsreferences/relations.md - Relation queries and nested operationsreferences/transactions.md - Transaction APIreferences/raw-queries.md - $queryRaw, $executeRawreferences/client-methods.md - $connect, $disconnect, $on, $extendsFilter Operators
| Operator | Description |
|---|---|
equals | Exact match |
not | Not equal |
in | In array |
notIn | Not in array |
lt, lte | Less than |
gt, gte | Greater than |
contains | String contains |
startsWith | String starts with |
endsWith | String ends with |
mode | Case sensitivity |
Relation Filters
| Operator | Description |
|---|---|
some | At least one related record matches |
every | All related records match |
none | No related records match |
is | Related record matches (1-to-1) |
isNot | Related record doesn't match |
Resources
- Prisma Client API Reference
- CRUD Operations
- Filtering and Sorting
How to Use
Pick the category from the table above, then open the matching reference file for implementation details and examples.
Tous les fichiers
9 fichiersInstaller prisma-client-api
Téléchargez et décompressez les fichiers de compétences dans votre répertoire .claude/skills/.
Télécharger le ZIPClonez le dépôt et copiez les fichiers de compétence dans votre projet.
git clone https://github.com/prisma/skills/blob/main/prisma-client-api/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Copier
