關聯式資料庫
了解如何將 Prisma ORM 新增至現有的 Node.js 或 TypeScript 專案,方法是將其連線到您的資料庫並產生用於資料庫存取的 Prisma Client。以下教學課程向您介紹 Prisma CLI、Prisma Client 和 Prisma Introspection。
提示
如果您要從另一個 ORM 遷移到 Prisma ORM,請參閱我們的從 TypeORM 遷移或從 Sequelize 遷移遷移指南。
先決條件
為了成功完成本指南,您需要
- 具有
package.json
的現有 Node.js 專案 - Node.js 安裝在您的機器上(請參閱系統需求以了解官方支援的版本)
- CockroachDB 資料庫伺服器正在執行中,且資料庫至少有一個表格
請參閱系統需求以了解確切的版本需求。
請確保您手邊有資料庫連線網址(包含您的驗證憑證)!如果您沒有正在執行的資料庫伺服器,只想探索 Prisma ORM,請查看快速入門。
設定 Prisma ORM
第一步,導航到包含 package.json
檔案的專案目錄中。
接下來,將 Prisma CLI 作為開發依賴項新增至您的專案
npm install prisma --save-dev
注意
如果您的專案包含多個具有 package.json
檔案的目錄(例如,frontend
、backend
等),請注意 Prisma ORM 專門設計用於 API/後端層。若要設定 Prisma,請導航到包含相關 package.json
檔案的適當後端目錄,並在那裡設定 Prisma。
您現在可以透過在 Prisma CLI 前面加上 npx
來調用它
npx prisma
資訊
請參閱安裝說明以了解如何使用不同的套件管理器安裝 Prisma ORM。
接下來,透過使用以下命令建立您的Prisma schema檔案範本來設定您的 Prisma ORM 專案
npx prisma init
此命令執行兩件事
- 建立一個名為
prisma
的新目錄,其中包含一個名為schema.prisma
的檔案,其中包含 Prisma schema 以及您的資料庫連線變數和 schema 模型 - 在專案的根目錄中建立
.env
檔案,該檔案用於定義環境變數(例如您的資料庫連線)