跳到主要内容

查询数据库

TypeScript
MongoDB

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

生成 Prisma Client 后，您就可以开始编写查询来读写数据库中的数据了。在本指南中，您将使用一个简单的 Node.js 脚本来探索 Prisma Client 的一些基本功能。

如果您正在构建 REST API，可以在路由处理程序中使用 Prisma Client 来根据传入的 HTTP 请求读写数据库中的数据。如果您正在构建 GraphQL API，可以在解析器中使用 Prisma Client 来根据传入的查询和变更读写数据库中的数据。

然而，在本指南中，您将创建一个简单的 Node.js 脚本来学习如何使用 Prisma Client 向数据库发送查询。一旦您理解了 API 的工作原理，就可以开始将其集成到您的实际应用程序代码中（例如 REST 路由处理程序或 GraphQL 解析器）。

创建一个名为 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. 连接到数据库
  5. 调用 main 函数
  6. 脚本终止时关闭数据库连接

在 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

如果您对带有记录的现有数据库进行了内省，查询应该返回一个 JavaScript 对象数组。

将数据写入数据库​

上一节中使用的 findMany 查询仅从数据库中读取数据（尽管当时是空的）。在本节中，您将学习如何编写查询以将新记录写入 Post、User 和 Comment 表中。

调整 main 函数以向数据库发送 create 查询

index.ts
async function main() {
  await prisma.user.create({
    data: {
      name: 'Rich',
      email: 'hello@prisma.com',
      posts: {
        create: {
          title: 'My first post',
          body: 'Lots of really interesting stuff',
          slug: 'my-first-post',
        },
      },
    },
  })

  const allUsers = await prisma.user.findMany({
    include: {
      posts: true,
    },
  })
  console.dir(allUsers, { depth: null })
}

此代码使用嵌套写入查询创建了一个新的 User 记录以及一个新的 Post。 User 记录通过 Post.author ↔ User.posts 关系字段分别与另一条记录连接。

请注意，您将 include 选项传递给了 findMany，这告诉 Prisma Client 在返回的 User 对象中包含 posts 关系。

使用此命令运行代码

npx tsx index.ts

输出应类似于此

[
  {
    id: '60cc9b0e001e3bfd00a6eddf',
    email: 'hello@prisma.com',
    name: 'Rich',
    posts: [
      {
        id: '60cc9bad005059d6007f45dd',
        slug: 'my-first-post',
        title: 'My first post',
        body: 'Lots of really interesting stuff',
        userId: '60cc9b0e001e3bfd00a6eddf',
      },
    ],
  },
]

另请注意，借助 Prisma Client 生成的类型，allUsers 是静态类型的。您可以通过在编辑器中将鼠标悬停在 allUsers 变量上来查看其类型。其类型应如下所示

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

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

此查询向 User 和 Post 集合添加了新记录

信息

Prisma schema 中的 id 字段映射到底层 MongoDB 数据库中的 _id。

User 集合

_idemailname
60cc9b0e001e3bfd00a6eddf"hello@prisma.com""Rich"

Post 集合

_idcreatedAttitlecontentpublishedauthorId
60cc9bad005059d6007f45dd2020-03-21T16:45:01.246Z"My first post"Lots of really interesting stufffalse60cc9b0e001e3bfd00a6eddf

注意：Post 文档字段中的唯一标识符 authorId 引用了 User 集合中的 _id 文档字段，这意味着 _id 值 60cc9b0e001e3bfd00a6eddf 因此引用了数据库中的第一条（也是唯一一条） User 记录。

在继续下一节之前，您将使用 update 查询为刚刚创建的 Post 记录添加一些评论。如下调整 main 函数

index.ts
async function main() {
  await prisma.post.update({
    where: {
      slug: 'my-first-post',
    },
    data: {
      comments: {
        createMany: {
          data: [
            { comment: 'Great post!' },
            { comment: "Can't wait to read more!" },
          ],
        },
      },
    },
  })
  const posts = await prisma.post.findMany({
    include: {
      comments: true,
    },
  })

  console.dir(posts, { depth: Infinity })
}

现在使用与之前相同的命令运行代码

npx tsx index.ts

您将看到以下输出

[
  {
    id: '60cc9bad005059d6007f45dd',
    slug: 'my-first-post',
    title: 'My first post',
    body: 'Lots of really interesting stuff',
    userId: '60cc9b0e001e3bfd00a6eddf',
    comments: [
      {
        id: '60cca420008a21d800578793',
        postId: '60cca40300af8bf000f6ca99',
        comment: 'Great post!',
      },
      {
        id: '60cca420008a21d800578794',
        postId: '60cca40300af8bf000f6ca99',
        comment: "Can't wait to try this!",
      },
    ],
  },
]

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