вариант

prisma-client-api

prisma/skills prisma/skills

Справочник по API Prisma Client, охватывающий запросы к модели, фильтры, операторы и клиентские методы. Используется при написании запросов к базе данных, выполнении операций CRUD, фильтрации данных или настройке Prisma Client. Триггеры для «prisma query», «findMany», «create», «update», «delete», «$transaction».

...Расширить все
58
Обновлено время 29 июня 2026 г.

О навыке «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.

Посмотреть на GitHub

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

PriorityCategoryImpactPrefix
1Client ConstructionHIGHconstructor
2Model QueriesCRITICALmodel-queries
3Query ShapeHIGHquery-options
4FilteringHIGHfilters
5RelationsHIGHrelations
6TransactionsCRITICALtransactions
7Raw SQLCRITICALraw-queries
8Client MethodsMEDIUMclient-methods

Quick Reference

  • constructor - PrismaClient setup, adapter wiring, logging, and SQL commenter plugins
  • model-queries - CRUD operations and bulk operations
  • query-options - select, include, omit, sort, pagination
  • filters - scalar and logical filter operators
  • relations - relation reads and nested writes
  • transactions - array and interactive transaction patterns
  • raw-queries - $queryRaw and $executeRaw safety
  • client-methods - lifecycle methods, extensions, and satisfies patterns for prisma-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

MethodDescription
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

OptionDescription
whereFilter conditions
selectFields to include
includeRelations to load
omitFields to exclude
orderBySort order
takeLimit results
skipSkip results (pagination)
cursorCursor-based pagination
distinctUnique values only

Client Methods

MethodDescription
$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, $extends

Filter Operators

OperatorDescription
equalsExact match
notNot equal
inIn array
notInNot in array
lt, lteLess than
gt, gteGreater than
containsString contains
startsWithString starts with
endsWithString ends with
modeCase sensitivity

Relation Filters

OperatorDescription
someAt least one related record matches
everyAll related records match
noneNo related records match
isRelated record matches (1-to-1)
isNotRelated 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.

Установить 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

Копировать Копировать
Быстрая настройка: Скопируйте папку со скиллом в каталог .claude/skills/ — Claude автоматически обнаружит и начнет использовать этот скилл
Репозиторий prisma/skills

Похожие навыки

github-code-search
Обновлено время 29 июня 2026 г.
drizzle-orm
Обновлено время 29 июня 2026 г.
clickhouse-io
Обновлено время 29 июня 2026 г.
coding-standards
Обновлено время 29 июня 2026 г.
OR