將 Prisma ORM 新增到使用 JavaScript 的現有 MongoDB 專案中

瞭解如何將 Prisma ORM 新增到現有的 Node.js 或 TypeScript 專案中，透過連線到資料庫並生成用於資料庫訪問的 Prisma Client。以下教程將向您介紹 Prisma CLI、Prisma Client 和 Prisma 內省。

提示

如果您正在從 Mongoose 遷移到 Prisma ORM，請參閱我們的從 Mongoose 遷移指南。

先決條件

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

Node.js 安裝在您的機器上（參閱系統要求以瞭解官方支援的版本）
訪問 MongoDB 4.2+ 伺服器，且已部署副本集。我們推薦使用 MongoDB Atlas。

警告
MongoDB 資料庫聯結器使用事務來支援巢狀寫入。事務需要部署副本集。部署副本集最簡單的方法是使用 Atlas。免費即可開始。

確保您手頭有資料庫連線 URL（包含您的身份驗證憑據）！如果您沒有執行資料庫伺服器，並且只想探索 Prisma ORM，請查閱快速入門。

參閱系統要求以瞭解確切的版本要求。

設定 Prisma ORM

作為第一步，請進入包含 package.json 檔案的專案目錄。

接下來，將 Prisma CLI 作為開發依賴項新增到您的專案中

npm install prisma --save-dev

注意

如果您的專案包含多個帶有 package.json 檔案的目錄（例如，frontend、backend 等），請注意 Prisma ORM 是專門為在 API/後端層中使用而設計的。要設定 Prisma，請導航到包含相關 package.json 檔案的相應後端目錄並在那裡配置 Prisma。

您現在可以透過在其字首新增 npx 來呼叫 Prisma CLI

npx prisma

資訊

參閱安裝說明，瞭解如何使用不同的包管理器安裝 Prisma ORM。

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

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

此命令執行以下幾項操作

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

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

prisma/schema.prisma

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

先決條件​

設定 Prisma ORM​

先決條件

設定 Prisma ORM