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