跳到主要內容

關聯式資料庫

了解如何將 Prisma ORM 新增至現有的 Node.js 或 TypeScript 專案,方法是將其連接到您的資料庫並產生用於資料庫存取的 Prisma Client。以下教學課程向您介紹 Prisma CLIPrisma ClientPrisma Introspection

提示

如果您要從另一個 ORM 遷移到 Prisma ORM,請參閱我們的 從 TypeORM 遷移從 Sequelize 遷移 遷移指南。

先決條件

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

  • 具有 package.json 的現有 Node.js 專案
  • Node.js 安裝在您的機器上 (請參閱 系統需求 以了解官方支援的版本)
  • PostgreSQL 資料庫伺服器正在執行中,且資料庫中至少有一個表格

請參閱 系統需求 以了解確切的版本需求。

確保您手邊有資料庫 連線 URL (包含您的驗證憑證)!如果您沒有正在執行的資料庫伺服器,只想探索 Prisma ORM,請查看 快速入門

設定 Prisma ORM

作為第一步,導覽至包含 package.json 檔案的專案目錄。

接下來,將 Prisma CLI 作為開發相依性新增至您的專案

npm install prisma --save-dev
注意

如果您的專案包含多個具有 package.json 檔案的目錄 (例如,frontendbackend 等),請注意,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 檔案,用於定義環境變數 (例如您的資料庫連線)