關係型資料庫(JavaScript 和 CockroachDB)
瞭解如何從頭開始建立一個新的 Node.js 或 TypeScript 專案,方法是將 Prisma ORM 連線到您的資料庫並生成一個用於資料庫訪問的 Prisma Client。本教程將向您介紹 Prisma CLI、Prisma Client 和 Prisma Migrate。
前提條件
為了成功完成本指南,您需要
- Node.js 安裝在您的機器上(請參閱 系統要求 以瞭解官方支援的版本)
- 正在執行的 CockroachDB 資料庫伺服器
請參閱 系統要求 以瞭解確切的版本要求。
確保您手頭有資料庫 連線 URL。如果您沒有正在執行的資料庫伺服器,只是想探索 Prisma ORM,請查閱 快速入門。
建立專案設定
作為第一步,建立一個專案目錄並進入該目錄
mkdir hello-prisma
cd hello-prisma
接下來,初始化一個 Node.js 專案並將 Prisma CLI 作為開發依賴項新增到其中
npm init -y
npm install prisma --save-dev
這會建立一個 package.json 檔案,其中包含 Node.js 應用程式的初始設定。
您現在可以透過在 Prisma CLI 前新增 npx 來呼叫它
npx prisma
接下來,透過以下命令建立您的 Prisma Schema 檔案來設定您的 Prisma ORM 專案
npx prisma init --datasource-provider postgresql --output ../generated/prisma
此命令會執行以下幾項操作
- 建立一個名為
prisma的新目錄,其中包含一個名為schema.prisma的檔案,該檔案包含帶有資料庫連線變數和模式模型的 Prisma Schema。 - 將
datasource設定為PostgreSQL並分別將輸出設定為自定義位置。 - 在專案的根目錄中建立
.env檔案,該檔案用於定義環境變數(例如您的資料庫連線)
請注意,prisma init 建立的預設模式使用 PostgreSQL 作為 provider。如果您沒有使用 datasource-provider 選項指定提供程式,則需要編輯 datasource 塊以改用 postgresql 提供程式
prisma/schema.prisma
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}