查询数据库
使用 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
- 定义一个
async
函数,命名为main
,用于向数据库发送查询 - 调用
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
关联字段 分别连接到其他两个记录。
请注意,你正在将 include
选项传递给 findMany
,它告诉 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,
}
}
]
另外请注意,allUsers
是 静态类型 的,这得益于 Prisma Client 生成的类型。你可以通过在编辑器中将鼠标悬停在 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 首次向数据库写入了新数据 🚀