Loading...
Loading...
Prisma Client API参考文档,涵盖模型查询、筛选器、操作符及客户端方法。适用于编写数据库查询、执行CRUD操作、筛选数据或配置Prisma Client的场景。触发关键词包括“prisma query”、“findMany”、“create”、“update”、“delete”、“$transaction”。
npx skill4agent add prisma/skills prisma-client-apiimport { PrismaClient } from '../generated/client'
import { PrismaPg } from '@prisma/adapter-pg'
const adapter = new PrismaPg({
connectionString: process.env.DATABASE_URL
})
const prisma = new PrismaClient({ adapter })| 方法 | 描述 |
|---|---|
| 通过唯一字段查找单条记录 |
| 查找单条记录,不存在则抛出错误 |
| 查找第一条匹配的记录 |
| 查找第一条匹配的记录,不存在则抛出错误 |
| 查找多条记录 |
| 创建一条新记录 |
| 创建多条记录 |
| 创建多条记录并返回结果 |
| 更新单条记录 |
| 更新多条记录 |
| 更新多条记录并返回结果 |
| 更新记录,不存在则创建 |
| 删除单条记录 |
| 删除多条记录 |
| 统计匹配的记录数量 |
| 聚合计算(求和、平均值等) |
| 分组并进行聚合计算 |
| 选项 | 描述 |
|---|---|
| 筛选条件 |
| 要包含的字段 |
| 要加载的关联关系 |
| 要排除的字段 |
| 排序规则 |
| 结果数量限制 |
| 跳过指定数量的结果(分页) |
| 基于游标分页 |
| 仅返回唯一值 |
| 方法 | 描述 |
|---|---|
| 显式连接数据库 |
| 断开数据库连接 |
| 执行事务 |
| 执行原生SQL查询 |
| 执行原生SQL命令 |
| 订阅事件 |
| 添加扩展 |
// 通过唯一字段查找
const user = await prisma.user.findUnique({
where: { email: 'alice@prisma.io' }
})
// 带筛选条件查找
const users = await prisma.user.findMany({
where: { role: 'ADMIN' },
orderBy: { createdAt: 'desc' },
take: 10
})const user = await prisma.user.create({
data: {
email: 'alice@prisma.io',
name: 'Alice',
posts: {
create: { title: 'Hello World' }
}
},
include: { posts: true }
})const user = await prisma.user.update({
where: { id: 1 },
data: { name: 'Alice Smith' }
})await prisma.user.delete({
where: { id: 1 }
})const [user, post] = await prisma.$transaction([
prisma.user.create({ data: { email: 'alice@prisma.io' } }),
prisma.post.create({ data: { title: 'Hello', authorId: 1 } })
])rules/constructor.md - PrismaClient构造函数选项
rules/model-queries.md - CRUD操作
rules/query-options.md - select, include, omit, where, orderBy
rules/filters.md - 筛选条件与操作符
rules/relations.md - 关联查询与嵌套操作
rules/transactions.md - 事务API
rules/raw-queries.md - $queryRaw, $executeRaw
rules/client-methods.md - $connect, $disconnect, $on, $extends| 操作符 | 描述 |
|---|---|
| 精确匹配 |
| 不匹配 |
| 在指定数组内 |
| 不在指定数组内 |
| 小于、小于等于 |
| 大于、大于等于 |
| 字符串包含指定内容 |
| 字符串以指定内容开头 |
| 字符串以指定内容结尾 |
| 大小写敏感性设置 |
| 操作符 | 描述 |
|---|---|
| 至少有一条关联记录匹配条件 |
| 所有关联记录均匹配条件 |
| 没有关联记录匹配条件 |
| 关联记录匹配指定条件(一对一关系) |
| 关联记录不匹配指定条件 |