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

データベースのクエリ

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`という名前の新しいファイルを作成し、次のコードを追加します

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

コードスニペットのさまざまな部分の簡単な概要を次に示します

  1. @prisma/client nodeモジュールからPrismaClientコンストラクターをインポートします
  2. PrismaClientをインスタンス化します
  3. データベースにクエリを送信するためにmainという名前のasync関数を定義します
  4. データベースに接続します
  5. main関数を呼び出します
  6. スクリプトが終了したらデータベース接続を閉じます

main関数内に、データベースからすべてのUserレコードを読み取り、結果を出力する次のクエリを追加します

index.js
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クエリは、データベースからデータを読み取るだけです(まだ空でしたが)。 このセクションでは、PostUser、およびCommentテーブルに新しいレコードを書き込むクエリを記述する方法を学びます。

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

index.js
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.authorUser.postsのリレーションフィールドを介して他方と接続されています。

findManyincludeオプションを渡していることに注意してください。これは、返された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コレクション

_idcreatedAtタイトルコンテンツ公開済みauthorId
60cc9bad005059d6007f45dd2020-03-21T16:45:01.246Z"My first post"Lots of really interesting stufffalse60cc9b0e001e3bfd00a6eddf

PostauthorIdドキュメントフィールドの一意の識別子は、Userコレクションの_idドキュメントフィールドを参照します。つまり、_id60cc9b0e001e3bfd00a6eddf列は、データベース内の最初(および唯一)のUserレコードを参照します。

次のセクションに進む前に、updateクエリを使用して、作成したばかりのPostレコードにいくつかのコメントを追加します。main関数を次のように調整します

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