リレーショナルデータベース
Prisma Postgresデータベースを備えた新しいTypeScriptプロジェクトをゼロから作成する方法を学びます。このチュートリアルでは、Prisma CLI、Prisma Client、およびPrisma Migrateを紹介し、次のワークフローについて説明します。
- ローカルマシンでTypeScriptプロジェクトをゼロから作成する
- Prisma Postgresデータベースを作成する
- スキーマの移行とクエリ(Prisma ORM経由)
- 接続プーリングとキャッシュ(Prisma Accelerate経由)
前提条件
このチュートリアルを正常に完了するには、以下が必要です。
- a(PDP)アカウント
- Node.js がマシンにインストールされていること(公式にサポートされているバージョンについてはシステム要件を参照してください)(公式にサポートされているバージョンについてはシステム要件を参照してください)
プロジェクト設定の作成
プロジェクトディレクトリを作成し、そこに移動します。
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
これで、npx
をプレフィックスとして付けてPrisma CLIを呼び出すことができます。
npx prisma
次に、次のコマンドを使用してPrismaスキーマファイルを作成して、Prisma ORMプロジェクトを設定します。
npx prisma init --db --output ../generated/prisma
このコマンドはいくつかのことを行います。
prisma
という名前の新しいディレクトリを作成します。このディレクトリには、データベース接続変数とスキーマモデルを含むPrismaスキーマを含むschema.prisma
というファイルが含まれています。output
をカスタムロケーションに設定します。- プロジェクトのルートディレクトリに
.env
ファイルを作成します。これは、(データベース接続やAPIキーなどの)環境変数を定義するために使用されます。
次のセクションでは、作成したばかりのファイルシステム上のプロジェクトにPrisma Postgresデータベースを接続する方法を学びます。
バージョン管理を使用していますか?
gitなどのバージョン管理を使用している場合は、生成されたクライアントをアプリケーションから除外するために、.gitignore
に行を追加することをお勧めします。この例では、generated/prisma
ディレクトリを除外します。
.gitignore
generated/prisma/