查询数据库
使用 Prisma Client 编写你的第一个查询
在你生成 Prisma Client 后,你就可以开始编写查询来读取和写入数据库中的数据了。在本指南中,你将使用一个普通的 Node.js 脚本来探索 Prisma Client 的一些基本功能。
创建一个名为 index.ts
的新文件并将以下代码添加到其中
import { PrismaClient } from '@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
函数 - 脚本终止时关闭数据库连接
在 main
函数内部,添加以下查询以从数据库中读取所有 User
记录并打印结果
async function main() {
// ... you will write your Prisma Client queries here
const allUsers = await prisma.user.findMany()
console.log(allUsers)
}
现在使用此命令运行代码
npx tsx index.ts
这应该会打印一个空数组,因为数据库中还没有 User
记录
[]
向数据库写入数据
你在上一节中使用的 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
关联字段 分别连接到其他两个记录。
注意,你向 findMany
传递了 include
选项,这告诉 Prisma Client 在返回的 User
对象上包含 posts
和 profile
关联。
使用此命令运行代码
npx tsx index.ts
输出应类似于此
[
{
email: 'alice@prisma.io',
id: 1,
name: 'Alice',
posts: [
{
content: null,
createdAt: 2020-03-21T16:45:01.246Z,
updatedAt: 2020-03-21T16:45:01.246Z,
id: 1,
published: false,
title: 'Hello World',
authorId: 1,
}
],
profile: {
bio: 'I like turtles',
id: 1,
userId: 1,
}
}
]
另请注意,由于 Prisma Client 生成的类型,allUsers
是 静态类型 的。你可以在编辑器中将鼠标悬停在 allUsers
变量上来查看其类型。它的类型应如下所示
const allUsers: (User & {
posts: Post[]
})[]
export type Post = {
id: number
title: string
content: string | null
published: boolean
authorId: number | null
}
查询将新记录添加到了 User
和 Post
表中
User
id | name | |
---|---|---|
1 | "alice@prisma.io" | "Alice" |
Post
id | createdAt | updatedAt | title | content | published | authorId |
---|---|---|---|---|---|---|
1 | 2020-03-21T16:45:01.246Z | 2020-03-21T16:45:01.246Z | "Hello World" | null | false | 1 |
Profile
id | bio | userId |
---|---|---|
1 | "I like turtles" | 1 |
注意:
Post
表中authorId
列和Profile
表中userId
列中的数字都引用了User
表的id
列,这意味着id
值1
列因此引用了数据库中的第一个(也是唯一一个)User
记录。
在继续下一节之前,你将使用 update
查询“发布”刚刚创建的 Post
记录。调整 main
函数如下
async function main() {
const post = await prisma.post.update({
where: { id: 1 },
data: { published: true },
})
console.log(post)
}
现在使用与之前相同的命令运行代码
npx tsx index.ts
你将看到以下输出
{
id: 1,
title: 'Hello World',
content: null,
published: true,
authorId: 1
}
数据库中 id
为 1
的 Post
记录现已更新
Post
id | title | content | published | authorId |
---|---|---|---|---|
1 | "Hello World" | null | true | 1 |
太棒了,你刚刚使用 Prisma Client 首次向数据库写入了新数据 🚀