關係型資料庫 (TypeScript 和 PostgreSQL)
瞭解如何透過連線 Prisma ORM 到你的資料庫並生成一個 Prisma Client 用於資料庫訪問,從而從零開始建立一個新的 Node.js 或 TypeScript 專案。以下教程將向你介紹 Prisma CLI、Prisma Client 和 Prisma Migrate。
前置條件
要成功完成本指南,你需要
- 你的機器上安裝了 Node.js (請參閱 系統要求 以瞭解官方支援的版本)
- 一個正在執行的 PostgreSQL 資料庫伺服器
有關確切的版本要求,請參閱 系統要求。
請確保你手邊有資料庫連線 URL。如果你沒有正在執行的資料庫伺服器,只是想探索 Prisma ORM,請檢視 快速入門。
建立專案設定
第一步,建立一個專案目錄並進入該目錄
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
資訊
請參閱安裝說明以瞭解如何使用不同的包管理器安裝 Prisma。
現在你可以透過在 Prisma CLI 字首 npx 來呼叫它
npx prisma
接下來,使用以下命令建立你的 Prisma Schema 檔案,從而設定你的 Prisma ORM 專案
npx prisma init --datasource-provider postgresql --output ../generated/prisma
此命令執行以下幾項操作
- 建立一個名為
prisma的新目錄,其中包含一個名為schema.prisma的檔案,該檔案包含 Prisma Schema 以及你的資料庫連線變數和 schema 模型。 - 將
datasource設定為PostgreSQL並分別將輸出設定為自定義位置。 - 在專案根目錄中建立
.env檔案,該檔案用於定義環境變數(例如你的資料庫連線)
請注意,由 prisma init 建立的預設 schema 使用 PostgreSQL 作為 provider。如果你沒有使用 datasource-provider 選項指定提供程式,則需要編輯 datasource 塊以改用 postgresql 提供程式
prisma/schema.prisma
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}