查詢資料庫

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

以下是程式碼片段中不同部分的快速概觀

從 @prisma/client node 模組匯入 PrismaClient 建構子
實例化 PrismaClient
定義一個名為 main 的 async 函數，以將查詢傳送至資料庫
呼叫 main 函數
在腳本終止時關閉資料庫連線

在 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 關聯欄位分別連接到其他兩個記錄。

請注意，您正在將 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,
    }
  }
]

另請注意，由於 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

id	email	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 函數

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

id	title	content	published	authorId
`1`	`"Hello World"`	`null`	`true`	`1`

太棒了，您剛剛第一次使用 Prisma Client 將新資料寫入資料庫 🚀

使用 Prisma Client 撰寫您的第一個查詢​

將資料寫入資料庫​

使用 Prisma Client 撰寫您的第一個查詢

將資料寫入資料庫