關係型資料庫 (TypeScript 和 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
接下來,初始化一個 TypeScript 專案並新增 Prisma CLI 作為開發依賴項
npm init -y
npm install prisma typescript tsx @types/node --save-dev
這將建立一個 `package.json` 檔案,其中包含 TypeScript 應用程式的初始設定。
接下來,初始化 TypeScript
npx tsc --init
資訊
參閱安裝說明,瞭解如何使用不同的包管理器安裝 Prisma。
現在你可以透過在命令前加上 `npx` 來呼叫 Prisma CLI
npx prisma
接下來,使用以下命令建立你的 Prisma Schema 檔案,從而設定你的 Prisma ORM 專案
npx prisma init --datasource-provider cockroachdb --output ../generated/prisma
此命令執行以下操作:
- 建立一個名為 `prisma` 的新目錄,其中包含一個名為 `schema.prisma` 的檔案,該檔案包含 Prisma Schema 以及你的資料庫連線變數和模式模型。
- 將 `datasource` 設定為CockroachDB並分別將輸出設定為自定義位置。
- 在專案的根目錄中建立 `.env` 檔案,用於定義環境變數(例如你的資料庫連線)
請注意,`prisma init` 建立的預設模式使用 PostgreSQL 作為 `provider`。如果你沒有使用 `datasource-provider` 選項指定提供程式,則需要編輯 `datasource` 塊以改為使用 `cockroachdb` 提供程式
prisma/schema.prisma
datasource db {
provider = "cockroachdb"
url = env("DATABASE_URL")
}