Vercel

Prisma Postgres 的 Vercel Marketplace 整合將您的 Vercel 專案與 Prisma Postgres 實例進行連接。連接後，該整合將自動在您部署的 Vercel 應用程式中設定以下環境變數：

DATABASE_URL：以 postgres://... 開頭的直接 TCP 連接 URL。

這讓您能夠透過任何您想使用的 ORM 或資料庫函式庫（Prisma ORM、Drizzle、Kysely 等）連接到 Prisma Postgres 實例。

功能

無需離開 Vercel 儀表板即可建立並使用 Prisma Postgres 實例。
自動為生產環境（Production）與預覽環境（Preview）產生 Prisma Postgres URL。
簡化您的 Vercel 專案環境設定。
提供升級或降級 Prisma Postgres 定價方案的計費工作流程。
為 Next.js、Nuxt、SvelteKit 以及各種 ORM 和資料庫函式庫提供可立即部署的全端範本。

範本

在 Vercel Marketplace 上使用 Prisma Postgres 最簡單的方法是透過其中一個範本：

使用方法

安裝擴充功能

若要安裝擴充功能，請點擊 Prisma Postgres 整合頁面頂部的安裝 (Install) 按鈕。

該整合現在將顯示在您的整合列表中，例如 https://vercel.com/<VERCEL-TEAM>/~/integrations。

建立新資料庫

安裝完成後，您可以導覽至儲存空間 (Storage) 分頁並點擊建立資料庫 (Create Database)。

選擇 Prisma Postgres 並點擊繼續 (Continue)。接著為資料庫選擇區域 (Region) 與定價方案 (Pricing Plan)，然後再次點擊繼續 (Continue)。

最後，為資料庫輸入名稱 (Name) 並點擊建立 (Create)。

資料庫現在已準備就緒，可以連接到您的 Vercel 專案。

將資料庫連接至 Vercel 專案

在您的 Vercel 專案中，您現在可以點擊儲存空間 (Storage) 分頁，選擇您剛建立的資料庫，然後點擊連接 (Connect)。這會自動在該專案中設定 DATABASE_URL 環境變數，並讓您的應用程式存取您新建立的 Prisma Postgres 實例。

在 Prisma Studio 中檢視與編輯資料

若要檢視與編輯 Prisma Postgres 實例中的資料，您可以使用本機版本的 Prisma Studio。

在已設定 DATABASE_URL 的本機專案版本中，執行以下指令以開啟 Prisma Studio：

npx prisma studio

搭配 Prisma ORM 使用時的額外考量

確保您的專案使用正確的環境變數

確保 prisma.config.ts 檔案中的資料來源 (data source) 已設定為使用 DATABASE_URL 環境變數。

import 'dotenv/config';
import { defineConfig, env } from '@prisma/config';
export default defineConfig({
  datasource: {
    url: env('DATABASE_URL'),
  },
  schema: './prisma/schema.prisma',
});

在 `package.json` 的 `postinstall` 指令碼中產生 Prisma Client

為確保產生的 Prisma Client 函式庫在您部署的 Vercel 專案中可用，您應該在 package.json 檔案的 scripts 區段中加入 postinstall 指令碼。

package.json

{
  // ...
  "scripts": {
    // ...
    "postinstall": "prisma generate"
  }
  //
}

功能​

範本​

使用方法​

安裝擴充功能​

建立新資料庫​

將資料庫連接至 Vercel 專案​

在 Prisma Studio 中檢視與編輯資料​

搭配 Prisma ORM 使用時的額外考量​

確保您的專案使用正確的環境變數​

在 package.json 的 postinstall 指令碼中產生 Prisma Client​

功能

範本