Prisma Postgres

対話的なワークフローとプログラマティックワークフロー全体にわたって Prisma Postgres を作成、管理、統合するためのガイダンス。

適用対象

以下の場合にこのスキルを参照してください:

• Prisma Console から Prisma Postgres をセットアップする場合
• create-db で即座の一時的なデータベースをプロビジョニングする場合
• prisma postgres link を使用して既存のローカルプロジェクトをリンクする場合
• Management API 経由で Prisma Postgres リソースを管理する場合
• TypeScript/JavaScript で @prisma/management-api-sdk を使用する場合
• claim URL、接続文字列、リージョン、認証フローを処理する場合

優先度別ルールカテゴリー

優先度	カテゴリ	影響度	プレフィックス
1	CLI Provisioning	CRITICAL	create-db-cli
2	Management API	CRITICAL	management-api
3	Management API SDK	HIGH	management-api-sdk
4	Console and Connections	HIGH	console-and-connections

クイックリファレンス

• create-db-cli - 即座のデータベースと現在の CLI フラグ (--ttl、--copy、--quiet、--open)
• management-api - サービストークンと OAuth API ワークフロー
• management-api-sdk - トークンストレージを使用した型付き SDK の使用
• console-and-connections - Console 操作、prisma postgres link、直接 TCP 接続、serverless-driver の選択肢

コアワークフロー

1. Console ファーストワークフロー

手動でのセットアップと操作に Prisma Console を使用します:

• https://console.prisma.io を開く
• ワークスペースとプロジェクトを作成/選択
• プロジェクトサイドバーの Studio を使用してデータを表示/編集
• プロジェクト UI から直接接続詳細を取得

2. create-db による高速プロビジョニング

すぐにデータベースが必要な場合は create-db を使用します:

npx create-db@latest

エイリアス:

npx create-pg@latest
npx create-postgres@latest

アプリ統合の場合、create-db npm パッケージからプログラマティック API (create() / regions()) を使用することもできます。

一時的なデータベースは claim されない限り約 24 時間後に自動削除されます。

3. 既存のローカルプロジェクトをリンク

データベースが既に存在していて、ローカルプロジェクトを接続したい場合は prisma postgres link を使用します:

prisma postgres link

CI または他の非対話的な環境の場合:

prisma postgres link --api-key "<your-api-key>" --database "db_..."

このフローはローカルの .env を DATABASE_URL で更新してから、prisma generate と prisma migrate dev を実行できます。

4. Management API によるプログラマティックプロビジョニング

以下のエンドポイントを使用します:

https://api.prisma.io/v1

以下を使用してスキーマとエンドポイントを探索します:

• OpenAPI ドキュメント: https://api.prisma.io/v1/doc
• Swagger Editor: https://api.prisma.io/v1/swagger-editor

認証オプション:

• サービストークン (ワークスペースサーバー間)
• OAuth 2.0 (ユーザーに代わって操作)

5. Management API SDK による型安全な統合

インストールして使用:

npm install @prisma/management-api-sdk

既存のトークン用に createManagementApiClient を使用するか、OAuth とトークン更新用に createManagementApiSdk を使用します。

ルールファイル

詳細なガイダンスは以下に記載されています:

references/console-and-connections.md
references/create-db-cli.md
references/management-api.md
references/management-api-sdk.md

使用方法

高速セットアップの場合は references/create-db-cli.md から開始し、プログラマティックプロビジョニングが必要な場合は references/management-api.md または references/management-api-sdk.md に切り替えてください。