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

リレーショナルデータベース

TypeScript
MySQL

Prisma ORMをデータベースに接続し、データベースアクセス用のPrisma Clientを生成することで、Node.jsまたはTypeScriptの新しいプロジェクトを新規作成する方法を学びます。このチュートリアルでは、Prisma CLI、Prisma Client、Prisma Migrateを紹介します。

前提条件​

このガイドを正常に完了するには、以下が必要です

  • Node.js がマシンにインストールされていること（公式にサポートされているバージョンについては、システム要件を参照してください）
  • MySQL データベースサーバーが実行されていること

正確なバージョンの要件については、システム要件を参照してください。

データベースの接続URLを手元に用意してください。データベースサーバーが実行されておらず、Prisma ORMを試したいだけの場合は、クイックスタートを確認してください。

プロジェクトのセットアップを作成​

最初のステップとして、プロジェクトディレクトリを作成し、そのディレクトリに移動します

mkdir hello-prisma
cd hello-prisma

次に、TypeScriptプロジェクトを初期化し、Prisma CLIを開発依存関係として追加します

npm init -y
npm install prisma typescript tsx @types/node --save-dev

これにより、TypeScriptアプリの初期設定を含むpackage.jsonが作成されます。

次に、TypeScriptを初期化します

npx tsc --init
info

インストール手順を参照して、別のパッケージマネージャーを使用してPrismaをインストールする方法を学んでください。

これで、npxをプレフィックスとして付けることでPrisma CLIを呼び出すことができます

npx prisma

次に、次のコマンドでPrisma Schemaファイルを作成して、Prisma ORMプロジェクトをセットアップします

npx prisma init --datasource-provider mysql --output ../generated/prisma

このコマンドはいくつかのことを行います

  • データベース接続変数とスキーマモデルを含むPrisma Schemaを含むschema.prismaというファイルを含むprismaという新しいディレクトリを作成します。
  • データソースを次のように設定しますMySQLそして、出力をそれぞれカスタムの場所に設定します。
  • 環境変数（データベース接続など）を定義するために使用される、プロジェクトのルートディレクトリに.envファイルを作成します
バージョン管理を使用していますか？

gitのようなバージョン管理を使用している場合、生成されたクライアントをアプリケーションから除外するために、.gitignoreに1行追加することをお勧めします。この例では、generated/prismaディレクトリを除外します。

.gitignore
generated/prisma/

prisma initによって作成されたデフォルトのスキーマは、プロバイダーとしてPostgreSQLを使用していることに注意してください。datasource-providerオプションでプロバイダーを指定しなかった場合は、datasourceブロックを編集して代わりにmysqlプロバイダーを使用する必要があります

prisma/schema.prisma
datasource db {
  provider = "mysql"
  url      = env("DATABASE_URL")
}