跳到主要內容

查詢資料庫

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 結構描述中的 id 欄位對應到底層 MongoDB 資料庫中的 _id。

User 集合

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

Post 集合

_idcreatedAttitlecontentpublishedauthorId
60cc9bad005059d6007f45dd2020-03-21T16:45:01.246Z"我的第一篇文章"許多非常有趣的東西false60cc9b0e001e3bfd00a6eddf

注意：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 首次將新資料寫入資料庫 🚀