prisma-client-api
prisma/skills
Справочник по API Prisma Client, охватывающий запросы к модели, фильтры, операторы и клиентские методы. Используется при написании запросов к базе данных, выполнении операций CRUD, фильтрации данных или настройке Prisma Client. Триггеры для «prisma query», «findMany», «create», «update», «delete», «$transaction».
...Расширить всеО навыке «prisma-client-api»
Навык «prisma-client-api» представляет собой исчерпывающее руководство по взаимодействию с базами данных с помощью Prisma Client. Он упрощает процесс построения запросов, выполнения операций CRUD, применения фильтров, управления связями и обработки транзакций в проектах Prisma. Благодаря подробным инструкциям по созданию экземпляров клиента, запросам к моделям, параметрам запросов и выполнению необработанного SQL этот навык помогает разработчикам сократить количество ошибок и повысить эффективность при работе с реляционными базами данных. Он особенно полезен для обеспечения правильной структуры запросов и безопасного и эффективного выполнения сложных операций, таких как вложенные записи и транзакции.
Данный навык охватывает широкий спектр возможностей, включая методы запросов к модели, такие как findUnique, findMany, create, update, delete, upsert, а также функции агрегации, такие как count, aggregate и groupBy. Он также обеспечивает обширную поддержку параметров запросов, позволяя разработчикам фильтровать, выбирать, включать, исключать, сортировать, пагинатировать и обеспечивать уникальность значений. Также включены методы Prisma Client для управления жизненным циклом, подписки на события, выполнения необработанного SQL и клиентских расширений. Данный навык обеспечивает безопасное выполнение необработанных SQL-запросов и содержит рекомендации по использованию транзакций — как массивных, так и интерактивных — для поддержания целостности данных.
Целевая аудитория включает бэкенд-разработчиков, администраторов баз данных и инженеров полного цикла, работающих с JavaScript или TypeScript, которым необходимо эффективно взаимодействовать с базами данных через Prisma. Типичные сценарии использования включают создание веб-приложений, API и микросервисов, где критически важны точное извлечение, манипулирование и агрегирование данных. Курс также подходит для команд, которым требуется стандартный справочник по единообразным шаблонам запросов и лучшим практикам при реализации сложной реляционной логики или выполнении пакетных операций в производственных средах.
Часто задаваемые вопросы
Как создать экземпляр Prisma Client с пользовательским адаптером?
Вы можете создать экземпляр Prisma Client, импортировав PrismaClient и ваш адаптер, а затем передав конфигурацию адаптера в конструктор клиента, как показано в приведенном примере на TypeScript.
Какие операции с базой данных поддерживает Prisma Client?
Prisma Client поддерживает полный набор операций CRUD, включая findUnique, findMany, create, createMany, update, updateMany, upsert, delete и deleteMany. Он также поддерживает методы агрегации и группировки.
Может ли Prisma Client обрабатывать транзакции?
Да, Prisma Client поддерживает как массивные, так и интерактивные транзакции с помощью метода $transaction, что позволяет безопасно выполнять несколько запросов в рамках одной транзакции.
Поддерживается ли использование необработанного SQL и безопасно ли оно?
Prisma Client предоставляет методы $queryRaw и $executeRaw для выполнения необработанных SQL-запросов. Их следует использовать с осторожностью, чтобы избежать SQL-инъекций; в документации приведены рекомендации по безопасному использованию.
Каковы требования для использования этого навыка по API Prisma Client?
Вам понадобится проект Prisma с сгенерированным клиентом, поддерживаемой базой данных и соответствующим адаптером. Для создания экземпляра клиента и выполнения запросов требуются среды TypeScript или JavaScript.
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.
Все файлы
9 файловУстановить prisma-client-api
Скачайте файлы навыков и распакуйте их в каталог .claude/skills/.
Скачать ZIPКлонируйте репозиторий и скопируйте файлы навыка в свой проект.
git clone https://github.com/prisma/skills/blob/main/prisma-client-api/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Копировать





Дом
