跳到主要内容

查询数据库

TypeScript
PostgreSQL

使用 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. 定义一个名为 main 的 async 函数，用于向数据库发送查询
  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 查询只从数据库中**读取**数据（尽管当时是空的）。在本节中，你将学习如何编写查询，将新记录**写入**到 Post 和 User 表中。

调整 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 记录，以及新的 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

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
}

id 为 1 的 Post 记录现在已在数据库中更新

Post

idtitlecontentpublishedauthorId
1"Hello World"nulltrue1

太棒了，你刚刚使用 Prisma Client 第一次向数据库写入了新数据 🚀