メインコンテンツへスキップ

データベースのクエリ

Prisma Clientで最初のクエリを書く

Prisma Clientを生成したので、データベース内のデータを読み書きするクエリを書き始めることができます。このガイドでは、Prisma Clientの基本的な機能を試すために、プレーンなNode.jsスクリプトを使用します。

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. データベースにクエリを送信するasync関数mainを定義します
  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テーブルに新しいレコードを書き込むクエリを記述する方法を学びます。

データベースにcreateクエリを送信するようにmain関数を調整します

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のリレーションフィールドを介して他の2つに接続されています。

findManyにincludeオプションを渡していることに注意してください。これは、返されたUserオブジェクトにpostsおよびprofileリレーションを含めるようにPrisma Clientに指示します。

次のコマンドでコードを実行します

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を使用して初めてデータベースに新しいデータを書き込みました🚀