データベースのクエリ

Prisma Clientで最初のクエリを作成する

Prisma Clientを生成したので、データベース内のデータを読み書きするクエリの作成を開始できます。

REST APIを構築している場合、受信HTTPリクエストに基づいてデータベース内のデータを読み書きするために、ルートハンドラーでPrisma Clientを使用できます。GraphQL APIを構築している場合、受信クエリとミューテーションに基づいてデータベース内のデータを読み書きするために、リゾルバーでPrisma Clientを使用できます。

ただし、このガイドの目的のために、Prisma Clientを使用してデータベースにクエリを送信する方法を学ぶために、プレーンなNode.jsスクリプトを作成するだけです。APIの仕組みを理解したら、実際のアプリケーションコード（RESTルートハンドラーやGraphQLリゾルバーなど）に統合を開始できます。

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

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

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

モデルがどのように見えるかによって、Prisma Client APIも異なって見えます。たとえば、Userモデルがある場合、PrismaClientインスタンスはuserというプロパティを公開し、そのプロパティでfindMany、create、updateなどのCRUDメソッドを呼び出すことができます。プロパティはモデルにちなんで名付けられていますが、最初の文字は小文字になっています（したがって、Postモデルの場合はpost、Profileの場合はprofileと呼ばれます）。

次の例はすべて、Prismaスキーマのモデルに基づいています。

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

index.ts

async function main() {
  const allUsers = await prisma.user.findMany()
  console.log(allUsers)
}

次に、現在のTypeScriptセットアップでコードを実行します。tsxを使用している場合は、次のように実行できます

npx tsx index.ts

データベースイントロスペクションステップのスキーマを使用してデータベースを作成した場合、データベースにUserレコードがまだないため、クエリは空の配列を出力する必要があります。

[]

レコードを含む既存のデータベースをイントロスペクションした場合、クエリはJavaScriptオブジェクトの配列を返す必要があります。

データベースにデータを書き込む

前のセクションで使用した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 })
}

このコードは、ネストされた書き込みクエリを使用して、新しいPostレコードとProfileレコードとともに新しいUserレコードを作成します。Userレコードは、Post.author ↔ User.postsおよびProfile.user ↔ User.profileのリレーションフィールドを介して、他の2つのレコードにそれぞれ接続されています。

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

現在のTypeScriptセットアップでコードを実行します。tsxを使用している場合は、次のように実行できます

npx tsx index.ts

次のセクションに進む前に、updateクエリを使用して、作成したばかりのPostレコードを「公開」します。次のようにmain関数を調整します

index.ts

async function main() {
  const post = await prisma.post.update({
    where: { id: 1 },
    data: { published: true },
  })
  console.log(post)
}

現在のTypeScriptセットアップでコードを実行します。tsxを使用している場合は、次のように実行できます

npx tsx index.ts

Prisma Clientで最初のクエリを作成する​

データベースにデータを書き込む​

Prisma Clientで最初のクエリを作成する

データベースにデータを書き込む