關係型資料庫（TypeScript 和 PlanetScale）

瞭解如何從零開始建立一個新的 Node.js 或 TypeScript 專案，方法是將 Prisma ORM 連線到您的資料庫並生成 Prisma Client 以進行資料庫訪問。本教程將向您介紹 Prisma CLI、Prisma Client 和 Prisma Migrate。

先決條件

為了成功完成本指南，您需要

警告

本教程還假設您可以將更改推送到資料庫的 main 分支。如果您的 main 分支已提升為生產環境，請勿這樣做。

請參閱系統要求以獲取確切的版本要求。

請確保您手頭有資料庫連線 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。

現在，您可以透過在 Prisma CLI 前面加上 npx 來呼叫它

npx prisma

接下來，透過使用以下命令建立您的Prisma Schema檔案來設定您的 Prisma ORM 專案

npx prisma init --datasource-provider mysql --output ../generated/prisma

此命令會執行以下幾項操作

建立一個名為 prisma 的新目錄，其中包含一個名為 schema.prisma 的檔案，該檔案包含帶有您的資料庫連線變數和模式模型的 Prisma Schema。
將 datasource 設定為MySQL並將輸出分別設定到自定義位置。
在專案的根目錄中建立 .env 檔案，該檔案用於定義環境變數（例如您的資料庫連線）

請注意，由 prisma init 建立的預設模式使用 PostgreSQL 作為 provider。如果您沒有透過 datasource-provider 選項指定提供程式，則需要編輯 datasource 塊以改用 mysql 提供程式

prisma/schema.prisma

datasource db {
  provider = "mysql"
  url      = env("DATABASE_URL")
}