データベースのクエリ (TypeScriptとPostgreSQLを使用)
Prisma Clientで最初のクエリを記述する
Prisma Clientが生成されたので、データベース内のデータを読み書きするためのクエリの記述を開始できます。このガイドでは、Prisma Clientの基本的な機能を探索するために、プレーンなNode.jsスクリプトを使用します。
`index.ts`という新しいファイルを作成し、以下のコードを追加します
import { PrismaClient } from './generated/prisma'
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 init
コマンドで指定された出力フォルダからPrismaClientをインポートします。- `PrismaClient`をインスタンス化します
- データベースにクエリを送信するための`main`という`async`関数を定義します
- `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`のリレーションフィールドを介して他の2つのレコードに接続されます。
`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
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 |
Note: `Post`テーブルの`authorId`列と`Profile`テーブルの`userId`列の数値はどちらも`User`テーブルの`id`列を参照しており、`id`値`1`はデータベース内の最初の(そして唯一の)`User`レコードを指します。
次のセクションに進む前に、先ほど作成した`Post`レコードを`update`クエリを使用して「公開」します。`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を使用して初めてデータベースに新しいデータを書き込みました 🚀