データベースのクエリ
Prisma Clientで最初のクエリを記述する
Prisma Clientを生成したので、クエリを記述してデータベース内のデータを読み書きできるようになります。このガイドでは、Prisma Clientの基本的な機能をいくつか試すために、プレーンなNode.jsスクリプトを使用します。
index.ts
という名前の新しいファイルを作成し、次のコードを追加します。
import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()
async function main() {
// ... you will write your Prisma Client queries here
}
main()
.catch(async (e) => {
console.error(e)
process.exit(1)
})
.finally(async () => {
await prisma.$disconnect()
})
コードスニペットのさまざまな部分の簡単な概要を以下に示します。
@prisma/client
nodeモジュールからPrismaClient
コンストラクタをインポートします。PrismaClient
をインスタンス化します。- データベースにクエリを送信する
async
関数main
を定義します。 - データベースに接続します。
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
、およびComment
テーブルに新しいレコードを書き込む方法を学習します。
create
クエリをデータベースに送信するようにmain
関数を調整します。
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 })
}
このコードは、ネストされた書き込みクエリを使用して、新しいPost
と一緒に新しいUser
レコードを作成します。User
レコードは、Post.author
↔ User.posts
リレーションフィールドを介してそれぞれ他のレコードに接続されています。
Prisma Clientに返されたUser
オブジェクトのリレーションposts
を含めるように指示するinclude
オプションをfindMany
に渡していることに注意してください。
次のコマンドでコードを実行します。
npx tsx index.ts
出力は次のようになります。
[
{
id: '60cc9b0e001e3bfd00a6eddf',
email: 'hello@prisma.com',
name: 'Rich',
address: null,
posts: [
{
id: '60cc9bad005059d6007f45dd',
slug: 'my-first-post',
title: 'My first post',
body: 'Lots of really interesting stuff',
userId: '60cc9b0e001e3bfd00a6eddf',
},
],
},
]
また、allUsers
は、Prisma Clientの生成された型のおかげで静的に型付けされていることにも注意してください。エディターでallUsers
変数にカーソルを合わせると、型を確認できます。次のように型付けされているはずです。
const allUsers: (User & {
posts: Post[]
})[]
export type Post = {
id: number
title: string
body: string | null
published: boolean
authorId: number | null
}
クエリは、User
テーブルとPost
テーブルに新しいレコードを追加しました。
User
id | name | |
---|---|---|
60cc9b0e001e3bfd00a6eddf | "hello@prisma.com" | "Rich" |
Post
id | createdAt | title | content | published | authorId |
---|---|---|---|---|---|
60cc9bad005059d6007f45dd | 2020-03-21T16:45:01.246Z | "My first post" | たくさんの本当に興味深いもの | false | 60cc9b0e001e3bfd00a6eddf |
注:
Post
のauthorId
列の一意のIDは、User
テーブルのid
列を参照しています。つまり、id
値60cc9b0e001e3bfd00a6eddf
列は、データベース内の最初(および唯一)のUser
レコードを参照しています。
次のセクションに進む前に、update
クエリを使用して、作成したばかりのPost
レコードにいくつかのコメントを追加します。main
関数を次のように調整します。
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 🚀 を使用して初めてデータベースに新しいデータを書き込みました。