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

既存のPlanetScaleデータベースをJavaScriptとPrisma ORMでクエリする

JavaScript
PlanetScale

Prisma Clientで最初のクエリを記述する​

Prisma Clientを生成したので、データベースのデータの読み書きを行うクエリの記述を開始できます。

REST APIを構築している場合、Prisma Clientをルートハンドラーで使用して、受信HTTPリクエストに基づいてデータベースのデータの読み書きを行うことができます。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ノードモジュールからPrismaClientコンストラクターをインポートします。
  2. PrismaClientをインスタンス化します。
  3. データベースにクエリを送信するためのmainという名前のasync関数を定義します。
  4. main関数を呼び出します。
  5. スクリプトが終了したらデータベース接続を閉じます。

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

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

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

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

次に、このコマンドでコードを実行します。

node index.js

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

[]

レコードを含む既存のデータベースをイントロスペクトした場合、クエリはJavaScriptオブジェクトの配列を返すはずです。

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

前のセクションで使用したfindManyクエリは、データベースからデータを読み取るだけでした。このセクションでは、PostおよびUserテーブルに新しいレコードを書き込むクエリの記述方法を学びます。

main関数を調整して、データベースにcreateクエリを送信します。

index.js
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に指示します。

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

node index.js

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

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

次に、以前と同じコマンドを使用してコードを実行します。

node index.js
© . All rights reserved.