リレーショナルデータベース(TypeScriptと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
次に、TypeScriptプロジェクトを初期化し、Prisma CLIを開発依存関係として追加します
npm init -y
npm install prisma typescript tsx @types/node --save-dev
これにより、TypeScriptアプリの初期設定を含む`package.json`が作成されます。
次に、TypeScriptを初期化します
npx tsc --init
別のパッケージマネージャーを使用してPrismaをインストールする方法については、インストール手順を参照してください。
これで、`npx`を前に付けてPrisma CLIを呼び出すことができます
npx prisma
次に、次のコマンドを使用してPrisma Schemaファイルを作成し、Prisma ORMプロジェクトをセットアップします
npx prisma init --datasource-provider postgresql --output ../generated/prisma
このコマンドはいくつかのことを行います
- `prisma`という新しいディレクトリを作成し、その中に`schema.prisma`というファイルを作成します。このファイルには、データベース接続変数とスキーマモデルを含むPrisma Schemaが含まれています。
- `datasource`を以下に設定しますPostgreSQLまた、それぞれ出力先をカスタムロケーションに設定します。
- プロジェクトのルートディレクトリに
.env
ファイルを作成します。これは、環境変数(データベース接続など)を定義するために使用されます。
`prisma init`によって作成されるデフォルトのスキーマは、`provider`としてPostgreSQLを使用することに注意してください。`datasource-provider`オプションでプロバイダーを指定しなかった場合、`datasource`ブロックを編集して`postgresql`プロバイダーを使用する必要があります。
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}