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

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

TypeScript
MySQL

Prisma Clientで最初のクエリを書く​

Prisma Clientを生成したら、データベースのデータの読み書きを行うクエリを書き始めることができます。

REST APIを構築している場合、Prisma Clientをルートハンドラーで使用して、受信するHTTPリクエストに基づいてデータベースのデータを読み書きできます。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)
  })

ここでは、コードスニペットの各部分の簡単な概要を説明します。

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

モデルの構造によって、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`テーブルに新しいレコードを_書き込む_クエリの作成方法を学びます。

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

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

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

戻り値の`User`オブジェクトに`posts`および`profile`リレーションを含めるようにPrisma Clientに指示するincludeオプションを`findMany`に渡している点に注目してください。

現在のTypeScript設定でコードを実行します。`tsx`を使用している場合は、次のように実行できます。

npx tsx index.ts

次のセクションに進む前に、作成した`Post`レコードを`update`クエリを使用して「公開」します。`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
© . All rights reserved.