關係型資料庫(JavaScript 和 PlanetScale)
瞭解如何從零開始建立一個新的 Node.js 或 TypeScript 專案,透過連線 Prisma ORM 到您的資料庫並生成 Prisma Client 來訪問資料庫。本教程將向您介紹 Prisma CLI、Prisma Client 和 Prisma Migrate。
先決條件
為了成功完成本指南,您需要
- Node.js 已安裝在您的機器上(有關官方支援的版本,請參閱系統要求)
- 一個正在執行的 PlanetScale 資料庫伺服器
警告
本教程也假設您可以推送到資料庫的 main 分支。如果您的 main 分支已提升到生產環境,請勿這樣做。
接下來,初始化一個 Node.js 專案並將其新增 Prisma CLI 作為開發依賴項
npm init -y
npm install prisma --save-dev
這將建立一個包含 Node.js 應用程式初始設定的 package.json 檔案。
資訊
請參閱 安裝說明,瞭解如何使用不同的包管理器安裝 Prisma。
您現在可以透過在命令前加上 npx 來呼叫 Prisma CLI
npx prisma
接下來,使用以下命令建立您的 Prisma Schema 檔案,從而設定您的 Prisma ORM 專案
npx prisma init --datasource-provider mysql --output ../generated/prisma
此命令會執行以下操作
- 建立一個名為
prisma的新目錄,其中包含一個名為schema.prisma的檔案,該檔案包含 Prisma Schema 以及您的資料庫連線變數和 schema 模型。 - 將
datasource設定為MySQL並分別將輸出設定為自定義位置。 - 在專案根目錄中建立
.env檔案,該檔案用於定義環境變數(例如您的資料庫連線)
請注意,由 prisma init 建立的預設 schema 使用 PostgreSQL 作為 provider。如果您沒有使用 datasource-provider 選項指定 provider,則需要編輯 datasource 塊以改用 mysql provider。
prisma/schema.prisma
datasource db {
provider = "mysql"
url = env("DATABASE_URL")
}