查询数据库
使用 Prisma Client 编写第一个查询
现在你已经生成了 Prisma Client,你可以开始编写查询来在数据库中读取和写入数据。在本指南中,你将使用一个纯粹的 TypeScript 脚本来探索 Prisma Client 的一些基本特性。
创建一个名为 queries.ts
的新文件,并添加以下代码:
// 1
import { PrismaClient } from '@prisma/client'
import { withAccelerate } from '@prisma/extension-accelerate'
// 2
const prisma = new PrismaClient()
.$extends(withAccelerate())
// 3
async function main() {
// ... you will write your Prisma Client queries here
}
// 4
main()
.then(async () => {
await prisma.$disconnect()
})
.catch(async (e) => {
console.error(e)
// 5
await prisma.$disconnect()
process.exit(1)
})
以下是代码片段不同部分的快速概述:
- 导入
PrismaClient
构造函数和withAccelerate
扩展。 - 实例化
PrismaClient
并添加 Accelerate 扩展。 - 定义一个名为
main
的async
函数,用于向数据库发送查询。 - 调用
main
函数。 - 当脚本终止时关闭数据库连接。
在 main
函数内部,添加以下查询以从数据库读取所有 User
记录并打印结果:
async function main() {
const allUsers = await prisma.user.findMany()
console.log(allUsers)
}
现在使用此命令运行代码:
npx tsx queries.ts
这应该会打印一个空数组,因为数据库中还没有 User
记录:
[]
向数据库写入数据
你在上一节使用的 findMany
查询只从数据库中**读取**数据(尽管当时是空的)。
在本节中,你将学习如何编写一个查询,以便一次性向 Post
、User
和 Profile
表写入新记录。
通过删除之前的代码并添加以下内容来调整 main
函数:
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
记录。
这些记录通过你在 Prisma schema 中定义的**关系字段**连接起来。
请注意,你还向 findMany
传递了 include
选项,这告诉 Prisma Client 在返回的 User
对象上包含 posts
和 profile
关系。
使用此命令运行代码:
npx tsx queries.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: ({
posts: {
id: number;
createdAt: Date;
updatedAt: Date;
title: string;
content: string | null;
published: boolean;
authorId: number;
}[];
profile: {
id: number;
bio: string | null;
userId: number;
} | null;
} & {
...;
})[]
展开以查看已创建记录的可视化视图:
查询向 User
、Post
和 Profile
表添加了新记录:
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 queries.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 查询 Prisma Postgres 数据库。如果你在学习过程中遇到了困难,想了解更多查询或探索 Prisma Accelerate 的缓存功能,请查看完整的 Prisma starter template。