跳到主要内容

查询数据库

使用 Prisma Client 编写你的第一个查询

现在你已经生成了 Prisma Client,你可以开始编写查询来在数据库中读写数据。为了本指南的目的,你将使用一个简单的 Node.js 脚本来探索 Prisma Client 的一些基本功能。

创建一个新文件,命名为 index.ts,并将以下代码添加到其中

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

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

  1. @prisma/client node 模块导入 PrismaClient 构造函数
  2. 实例化 PrismaClient
  3. 定义一个 async 函数,命名为 main,用于向数据库发送查询
  4. 调用 main 函数
  5. 脚本终止时关闭数据库连接

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

index.ts
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 查询只 读取 数据库中的数据(尽管当时是空的)。在本节中,你将学习如何编写查询来 写入 新的记录到 PostUser 表中。

修改 main 函数,使其发送一个 create 查询到数据库

index.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 记录。该 User 记录通过 Post.authorUser.postsProfile.userUser.profile 关联字段 分别连接到其他两个记录。

请注意,你正在将 include 选项传递给 findMany,它告诉 Prisma Client 在返回的 User 对象中包含 postsprofile 关联字段。

使用此命令运行代码

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,
}
}
]

另外请注意,allUsers静态类型 的,这得益于 Prisma Client 生成的类型。你可以通过在编辑器中将鼠标悬停在 allUsers 变量上来查看其类型。它的类型应该是这样的

const allUsers: (User & {
posts: Post[]
})[]

export type Post = {
id: number
title: string
content: string | null
published: boolean
authorId: number | null
}

该查询向 UserPost 表中添加了新记录

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 列,这意味着 id 值为 1 的列因此指向数据库中的第一个(也是唯一的)User 记录。

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

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

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

Post

idtitlecontentpublishedauthorId
1"Hello World"nulltrue1

太棒了,你刚刚使用 Prisma Client 首次向数据库写入了新数据 🚀