prisma-postgres-setup

Prisma Postgres のセットアップ

対象のデータベースに接続し、アプリケーションから接続を確認します。プロビジョニングと ORM の設定は分け、既存のデータベースを再利用してください。

1. プロジェクトを確認する

ユーザーが指定した ORM またはドライバー、インストール済みパッケージ、データベース接続、環境変数の読み込みに使われるファイルを確認します。値を表示せず、シークレットが設定されているかを確認してください。

• Drizzle、pg、データベースのみのセットアップなど、明示された選択を尊重します。
• すでに設定済みのアプリでクエリやスキーマの作業を行う場合は、バージョンに対応した ORM のガイダンスを使用し、セットアップを最初からやり直さないでください。

2. データベースを再利用または取得する

状況	対応
既存の接続、または接続済みのインテグレーション	プロジェクト、データベース、環境を確認し、再利用します。
v0、Vercel Marketplace、または Vercel プロジェクト	Marketplace のセットアップを読み、ネイティブのインテグレーションフローを使用します。
まだデータベースがなく、プロバイダーも指定されていない	アカウント不要で、すぐに使えるデータベースを利用できる npx create-db@latest（申請しない場合は24時間後に削除され、申請には無料の Prisma アカウントが必要です。プロビジョニングの create-db セクションを参照）、またはプロビジョニングによる永続データベースを提案します。依頼内容に指定がなければ、どちらを使うか尋ねてください。
スタンドアロンの永続データベース	プロビジョニングを読み、認証済み CLI、MCP ツール、コンソール、または Management API を使用します。
一時的な開発用データベースが求められている	有効期限と申請手順を含め、プロビジョニングの create-db セクションを読みます。

作成前にワークスペース、プロジェクト、リージョンを確定します。条件に合うリソースが複数ある場合は、どれを使うか尋ねてください。権限やクォータの制限でプロビジョニングできない場合は、その制約を報告してください。回避するために別のリソースを削除したり、ワークスペースを切り替えたりしないでください。

3. アプリケーションを接続する

選択したドライバーとランタイムに適した方法で接続します。接続情報はプロジェクトのシークレット用環境設定に保存し、ソースコードやチャットには記載しないでください。関係のない項目は維持し、対象の変数は一度だけ更新して、ローカルのシークレットファイルが Git の対象外になっていることを確認します。

アプリケーションのプロセスと CLI コマンドでは、読み込む環境ファイルが異なる場合があります。たとえば、フレームワークが .env.development.local を読み込む一方で、シェルコマンドは読み込まないことがあります。シェルで変数が見つからなくても、データベースが存在しないとは限りません。認証情報を表示せずに、そのコマンドで指定のファイルを読み込み、別のデータベースをプロビジョニングしないでください。

4. ORM を設定して検証する

Prisma ORM をセットアップする場合は、prisma-orm-setup/SKILL.mdを直接読むか、ホストが名前で兄弟スキルを解決できる場合は、インストール済みの prisma-orm-setup スキルを読み込みます。ORM のバージョン選択と設定は、このスキルに従います。この引き継ぎが利用できない場合は、その旨を報告してください。

別の ORM を明示的に選択している場合は、その ORM またはドライバーを維持し、ドキュメントに沿ってセットアップします。データベースのみのセットアップでは、接続を検証した時点で終了します。

アプリケーションで選択した ORM またはドライバーを通じて、対象のデータベースに読み取り専用クエリを実行します。接続先、選択した ORM とバージョン、クエリ結果を、シークレットを含めずに報告してください。手順がブロックされた場合や未テストの場合は、セットアップが完了したと断言せず、その旨を伝えてください。

Studio、SDK インテグレーション、または初期セットアップ以外のデータベース操作については、操作ガイドを読んでください。