Vercel
Vercel MarketplaceのPrisma Postgres統合は、VercelプロジェクトをPrisma Postgresインスタンスに接続します。一度接続すると、統合によりデプロイされたVercelアプリケーションにDATABASE_URL
環境変数が自動的に設定されます。
機能
- Vercelダッシュボードから離れることなくPrisma Postgresインスタンスを作成・使用できます。
- 本番環境およびプレビュー環境向けのPrisma Postgres URLキーの自動生成。
- Vercelプロジェクトの環境設定を簡素化。
- Prisma Postgresの料金プランをアップグレード/ダウングレードするための請求ワークフロー。
- 認証付きのすぐにデプロイ可能なフルスタックNext.jsのテンプレート。
使用方法
注: Prisma Postgres拡張機能を使用する最も簡単な方法は、Next.js認証テンプレートを利用することです。
拡張機能をインストールする
拡張機能をインストールするには、Prisma Postgres統合ページの上部にあるインストールをクリックしてください。
統合は、https://vercel.com/<VERCEL-TEAM>/~/integrations
のように、統合リストに表示されます。
新しいデータベースを作成する
インストール後、Storageタブに移動し、Create Databaseをクリックします。
Prisma Postgresを選択し、続行をクリックします。次に、データベースのリージョンと料金プランを選択し、再度続行をクリックします。
最後に、データベースに名前を付け、作成をクリックします。
データベースの準備が整い、Vercelプロジェクトに接続できるようになりました。
データベースをVercelプロジェクトに接続する
Vercelプロジェクトで、Storageタブをクリックし、作成したデータベースを選択してから接続をクリックします。これにより、そのプロジェクトにDATABASE_URL
環境変数が自動的に設定され、アプリケーションが新しく作成されたPrisma Postgresインスタンスにアクセスできるようになります。
Prisma Studioでのデータの表示と編集
Prisma Postgresインスタンス内のデータを表示および編集するには、Prisma Studioのローカルバージョンを使用できます。
DATABASE_URL
が設定されているプロジェクトのローカルバージョンで、次のコマンドを実行してPrisma Studioを開きます。
npx prisma studio
その他の考慮事項
プロジェクトがDATABASE_URL
環境変数を使用していることを確認する
schema.prisma
ファイル内のデータソースがDATABASE_URL
環境変数を使用するように構成されていることを確認してください。
// schema.prisma
generator client {
provider = "prisma-client-js"
}
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}
package.json
のpostinstall
スクリプトでPrisma Clientを生成する
生成されたPrisma ClientライブラリがデプロイされたVercelプロジェクトで利用可能であることを確認するために、package.json
ファイルのscripts
セクションにpostinstall
スクリプトを追加する必要があります。
{
// ...
"scripts": {
// ...
"postinstall": "prisma generate --no-engine"
}
//
}
--no-engine
フラグは、生成されたPrisma Clientライブラリからクエリエンジンバイナリを除外します。Prisma Postgresを使用する場合は不要です。
例: Prisma PostgresでNext.jsテンプレートをデプロイする
始めるには、当社のNext.jsスターターテンプレートをデプロイし、デプロイフロー中にPrisma Postgresインスタンス経由で接続できます。