Lar
prisma-client-api
prisma/skills
Referência da API do Prisma Client que abrange consultas a modelos, filtros, operadores e métodos do cliente. Utilize-a ao escrever consultas ao banco de dados, ao realizar operações CRUD, ao filtrar dados ou ao configurar o Prisma Client. Gatilhos em “prisma query”, “findMany”, “create”, “update”, “delete” e “$transaction”.
...Expandir tudoSobre o `prisma-client-api`
A habilidade “prisma-client-api” oferece uma referência abrangente para interagir com bancos de dados usando o Prisma Client. Ela simplifica o processo de construção de consultas, execução de operações CRUD, aplicação de filtros, gerenciamento de relações e tratamento de transações em projetos Prisma. Ao oferecer orientações detalhadas sobre instanciação do cliente, consultas de modelo, opções de consulta e execução de SQL bruto, essa skill ajuda os desenvolvedores a reduzir erros e melhorar a eficiência ao trabalhar com bancos de dados relacionais. Ela é particularmente útil para garantir que as consultas sejam estruturadas corretamente e que operações avançadas, como gravações aninhadas e transações, sejam tratadas com segurança e eficácia.
Esta habilidade abrange uma ampla gama de recursos, incluindo métodos de consulta de modelo, como findUnique, findMany, create, update, delete e upsert, além de funções de agregação, como count, aggregate e groupBy. Ela também oferece amplo suporte a opções de consulta, permitindo que os desenvolvedores filtrem, selecionem, incluam, omitam, classifiquem, paginem e imponham valores distintos. Também estão incluídos os métodos do Prisma Client para gerenciamento de ciclo de vida, assinaturas de eventos, execução de SQL bruto e extensões de cliente. A habilidade garante a execução segura de consultas SQL bruto e fornece orientações sobre o uso de transações, tanto baseadas em array quanto interativas, para manter a integridade dos dados.
Os usuários-alvo incluem desenvolvedores de back-end, administradores de banco de dados e engenheiros full-stack que trabalham com JavaScript ou TypeScript e precisam interagir de forma eficiente com bancos de dados por meio do Prisma. Casos de uso típicos envolvem a criação de aplicativos web, APIs e microsserviços nos quais a recuperação, manipulação e agregação precisas de dados são essenciais. Também é adequada para equipes que precisam de uma referência padrão para padrões consistentes de consulta e melhores práticas ao implementar lógica relacional complexa ou realizar operações em lote em ambientes de produção.
Perguntas frequentes
Como instanciar um Prisma Client com um adaptador personalizado?
Você pode instanciar o Prisma Client importando PrismaClient e seu adaptador e, em seguida, passando a configuração do adaptador para o construtor do cliente, conforme mostrado no exemplo em TypeScript fornecido.
Quais operações de banco de dados são suportadas pelo Prisma Client?
O Prisma Client suporta todas as operações CRUD, incluindo findUnique, findMany, create, createMany, update, updateMany, upsert, delete e deleteMany. Ele também suporta métodos de agregação e agrupamento.
O Prisma Client suporta transações?
Sim, o Prisma Client suporta tanto transações baseadas em array quanto interativas usando o método $transaction, permitindo que várias consultas sejam executadas com segurança dentro de uma única transação.
O SQL bruto é suportado e seguro de usar?
O Prisma Client oferece os métodos $queryRaw e $executeRaw para a execução de consultas SQL bruto. Eles devem ser usados com cuidado para evitar injeção de SQL, e a documentação fornece orientações para o uso seguro.
Quais são os requisitos para usar esta habilidade de API do Prisma Client?
Você precisa de um projeto Prisma com um cliente gerado, um banco de dados compatível e um adaptador apropriado. São necessários ambientes TypeScript ou JavaScript para a instanciação do cliente e a execução de consultas.
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.
Todos os arquivos
9 arquivosInstalar prisma-client-api
Baixe e extraia os arquivos de habilidades para o diretório .claude/skills/.
Baixar ZIPClone o repositório e copie os arquivos da habilidade para o seu projeto.
git clone https://github.com/prisma/skills/blob/main/prisma-client-api/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Copiar
