メインコンテンツにスキップ

リレーショナルデータベース

Prisma Postgresデータベースを備えた新しいTypeScriptプロジェクトをゼロから作成する方法を学びます。このチュートリアルでは、Prisma CLIPrisma 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/