リレーショナルデータベース
Prisma ORMをデータベースに接続し、データベースアクセス用のPrisma Clientを生成することにより、Node.jsまたはTypeScriptの新しいプロジェクトを最初から作成する方法を学びます。次のチュートリアルでは、Prisma CLI、Prisma Client、およびPrisma Migrateを紹介します。
前提条件
このガイドを正常に完了するには、以下が必要です。
- Node.js がマシンにインストールされていること(公式にサポートされているバージョンについては、システム要件を参照してください)
- PlanetScale データベースサーバーが実行されていること
このチュートリアルでは、データベースのmain
ブランチにプッシュできることも前提としています。main
ブランチが本番環境に昇格している場合は、これを行わないでください。
次に、Node.jsプロジェクトを初期化し、Prisma CLIを開発依存関係として追加します。
npm init -y
npm install prisma --save-dev
これにより、Node.jsアプリの初期設定を含むpackage.json
が作成されます。
別のパッケージマネージャーを使用してPrismaをインストールする方法については、インストール手順を参照してください。
これで、npx
をプレフィックスとして付けてPrisma CLIを呼び出すことができます。
npx prisma
次に、次のコマンドを使用してPrisma Schemaファイルを作成してPrisma ORMプロジェクトをセットアップします。
npx prisma init --datasource-provider mysql --output ../generated/prisma
このコマンドはいくつかのことを行います。
- データベース接続変数とスキーマモデルを含むPrisma Schemaを含む
schema.prisma
というファイルを含むprisma
という新しいディレクトリを作成します。 datasource
を以下に設定します。MySQLそして、出力をそれぞれカスタムロケーションに設定します。- プロジェクトのルートディレクトリに、環境変数(データベース接続など)を定義するために使用される
.env
ファイルを作成します。
gitなどのバージョン管理を使用している場合は、生成されたクライアントをアプリケーションから除外するために、.gitignore
に行を追加することをお勧めします。この例では、generated/prisma
ディレクトリを除外します。
generated/prisma/
prisma init
によって作成されたデフォルトのスキーマは、provider
としてPostgreSQLを使用していることに注意してください。datasource-provider
オプションでプロバイダーを指定しなかった場合は、mysql
プロバイダーを使用するようにdatasource
ブロックを編集する必要があります。
datasource db {
provider = "mysql"
url = env("DATABASE_URL")
}