查询数据库
使用 Prisma Client 编写你的第一个查询
生成 Prisma Client 后,你就可以开始编写查询来读取和写入数据库中的数据了。
如果你正在构建 REST API,可以在路由处理程序中使用 Prisma Client 来根据传入的 HTTP 请求读取和写入数据库中的数据。如果你正在构建 GraphQL API,可以在解析器中使用 Prisma Client 来根据传入的查询和 mutation 读取和写入数据库中的数据。
然而,为了本指南的目的,你将只创建一个简单的 Node.js 脚本来学习如何使用 Prisma Client 向数据库发送查询。一旦理解了 API 的工作原理,就可以开始将其集成到你的实际应用代码中(例如 REST 路由处理程序或 GraphQL 解析器)。
创建一个名为 index.js
的新文件,并添加以下代码
const { PrismaClient } = require('@prisma/client')
const prisma = new PrismaClient()
async function main() {
// ... you will write your Prisma Client queries here
}
main()
.then(async () => {
await prisma.$disconnect()
})
.catch(async (e) => {
console.error(e)
await prisma.$disconnect()
process.exit(1)
})
以下是代码片段不同部分的快速概述
- 从
@prisma/client
node 模块导入PrismaClient
构造函数 - 实例化
PrismaClient
- 定义一个名为
main
的async
函数来向数据库发送查询 - 调用
main
函数 - 脚本终止时关闭数据库连接
根据你的 model 看起来是什么样子,Prisma Client API 也会有所不同。例如,如果你有一个 User
model,你的 PrismaClient
实例会暴露一个名为 user
的属性,你可以在其上调用 CRUD 方法,例如 findMany
、create
或 update
。属性名称取自 model,但第一个字母小写(因此对于 Post
model,它被称为 post
,对于 Profile
,它被称为 profile
)。
以下示例都基于 Prisma schema 中的 model。
在 main
函数内部,添加以下查询来读取数据库中的所有 User
记录并打印结果
async function main() {
const allUsers = await prisma.user.findMany()
console.log(allUsers)
}
现在使用此命令运行代码
node index.js
如果你使用数据库内省步骤中的 schema 创建了数据库,查询应该打印一个空数组,因为数据库中还没有 User
记录。
[]
如果你对包含记录的现有数据库进行了内省,查询应该返回一个 JavaScript 对象数组。
将数据写入数据库
上一节中使用的 findMany
查询只从数据库中读取数据。在本节中,你将学习如何编写查询来写入新记录到 Post
和 User
表中。
调整 main
函数以向数据库发送 create
查询
async function main() {
await prisma.user.create({
data: {
name: 'Alice',
email: 'alice@prisma.io',
posts: {
create: { title: 'Hello World' },
},
profile: {
create: { bio: 'I like turtles' },
},
},
})
const allUsers = await prisma.user.findMany({
include: {
posts: true,
profile: true,
},
})
console.dir(allUsers, { depth: null })
}
此代码使用 嵌套写入 查询创建一个新的 User
记录以及新的 Post
和 Profile
记录。User
记录通过 Post.author
↔ User.posts
和 Profile.user
↔ User.profile
关系字段分别与其他两个记录连接。
请注意,你正在将 include
选项传递给 findMany
,它告诉 Prisma Client 在返回的 User
对象上包含 posts
和 profile
关系。
使用此命令运行代码
node index.js
在继续下一节之前,你将使用 update
查询“发布”刚刚创建的 Post
记录。调整 main
函数如下
async function main() {
const post = await prisma.post.update({
where: { id: 1 },
data: { published: true },
})
console.log(post)
}
现在使用与之前相同的命令运行代码
node index.js