跳到主要内容

查询数据库

使用 Prisma Client 编写第一个查询

现在你已经生成了 Prisma Client,你可以开始编写查询来在数据库中读取和写入数据。在本指南中,你将使用一个纯粹的 TypeScript 脚本来探索 Prisma Client 的一些基本特性。

创建一个名为 queries.ts 的新文件,并添加以下代码:

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)
})

以下是代码片段不同部分的快速概述:

  1. 导入 PrismaClient 构造函数和 withAccelerate 扩展。
  2. 实例化 PrismaClient 并添加 Accelerate 扩展。
  3. 定义一个名为 mainasync 函数,用于向数据库发送查询。
  4. 调用 main 函数。
  5. 当脚本终止时关闭数据库连接。

main 函数内部,添加以下查询以从数据库读取所有 User 记录并打印结果:

queries.ts
async function main() {
const allUsers = await prisma.user.findMany()
console.log(allUsers)
}

现在使用此命令运行代码:

npx tsx queries.ts

这应该会打印一个空数组,因为数据库中还没有 User 记录:

[]

向数据库写入数据

你在上一节使用的 findMany 查询只从数据库中**读取**数据(尽管当时是空的)。

在本节中,你将学习如何编写一个查询,以便一次性向 PostUserProfile 表写入新记录。

通过删除之前的代码并添加以下内容来调整 main 函数:

queries.ts
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 记录以及新的 PostProfile 记录。

这些记录通过你在 Prisma schema 中定义的**关系字段**连接起来。

请注意,你还向 findMany 传递了 include 选项,这告诉 Prisma Client 在返回的 User 对象上包含 postsprofile 关系。

使用此命令运行代码:

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;
} & {
...;
})[]
展开以查看已创建记录的可视化视图:

查询向 UserPostProfile 表添加了新记录:

User

idemailname
1"alice@prisma.io""Alice"

Post

idcreatedAtupdatedAttitlecontentpublishedauthorId
12020-03-21T16:45:01.246Z2020-03-21T16:45:01.246Z"Hello World"nullfalse1

Profile

idbiouserId
1"I like turtles"1

Post 表中的 authorId 列和 Profile 表中的 userId 列中的数字都引用了 User 表的 id 列,这意味着 id1 因此指的是数据库中的第一个(也是唯一一个) User 记录。

在进入下一节之前,你将使用 update 查询“发布”刚才创建的 Post 记录。调整 main 函数如下:

queries.ts
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
}

id1Post 记录现在已在数据库中更新:

Post

idtitlecontentpublishedauthorId
1"Hello World"nulltrue1

恭喜!你现在已经学会了如何在应用程序中使用 Prisma Client 查询 Prisma Postgres 数据库。如果你在学习过程中遇到了困难,想了解更多查询或探索 Prisma Accelerate 的缓存功能,请查看完整的 Prisma starter template