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