データベースのクエリ
Prisma Clientで最初のクエリを記述する
Prisma Clientを生成したので、データベース内のデータを読み書きするクエリの記述を開始できます。 このガイドの目的のために、Prisma Clientの基本的な機能をいくつか試すために、プレーンなNode.jsスクリプトを使用します。
REST APIを構築している場合、受信HTTPリクエストに基づいてデータベース内のデータを読み書きするために、ルートハンドラーでPrisma Clientを使用できます。 GraphQL APIを構築している場合、受信クエリとミューテーションに基づいてデータベース内のデータを読み書きするために、リゾルバーでPrisma Clientを使用できます。
ただし、このガイドの目的のために、Prisma Clientを使用してデータベースにクエリを送信する方法を学ぶために、プレーンなNode.jsスクリプトを作成するだけです。 APIの仕組みを理解したら、実際のアプリケーションコード(例:RESTルートハンドラーまたはGraphQLリゾルバー)に統合を開始できます。
`index.js`という名前の新しいファイルを作成し、次のコードを追加します
const { PrismaClient } = require('@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
レコードを読み取り、結果を出力する次のクエリを追加します
async function main() {
- // ... you will write your Prisma Client queries here
+ const allUsers = await prisma.user.findMany()
+ console.log(allUsers)
}
次に、このコマンドでコードを実行します
node index.js
レコードを持つ既存のデータベースをイントロスペクションした場合、クエリはJavaScriptオブジェクトの配列を返すはずです。
データベースにデータを書き込む
前のセクションで使用した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
のリレーションフィールドを介して他方と接続されています。
findMany
にinclude
オプションを渡していることに注意してください。これは、返されたUser
オブジェクトのリレーションposts
を含めるようにPrisma Clientに指示します。
このコマンドでコードを実行します
node index.js
出力は次のようになります。
[
{
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',
},
],
},
]
クエリはUser
コレクションとPost
コレクションに新しいレコードを追加しました
Prismaスキーマのid
フィールドは、基盤となるMongoDBデータベースの_id
にマッピングされます。
Userコレクション
_id | メール | 名前 |
---|---|---|
60cc9b0e001e3bfd00a6eddf | "hello@prisma.com" | "Rich" |
Postコレクション
_id | createdAt | タイトル | コンテンツ | 公開済み | authorId |
---|---|---|---|---|---|
60cc9bad005059d6007f45dd | 2020-03-21T16:45:01.246Z | "My first post" | Lots of really interesting stuff | false | 60cc9b0e001e3bfd00a6eddf |
注:
Post
のauthorId
ドキュメントフィールドの一意の識別子は、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 })
}
次に、前と同じコマンドを使用してコードを実行します
node index.js
次の出力が表示されます
[
{
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を使用して初めてデータベースに新しいデータを書き込みました🚀