設定

先決條件

在開始使用 Prisma Postgres 的 Prisma Optimize 之前，請確保您具備以下項目

• A.
• 使用 Prisma Client 版本 5.0.0 或更高版本的專案（建議使用最新版本）。
• 一個 Prisma Postgres 資料庫。

注意

Prisma Optimize 旨在於本地環境中使用。請在 常見問題 (FAQ) 中了解更多資訊。

1. 啟動 Optimize

1. 登入您的.
2. 點擊左側導覽列上的 Optimize 分頁。
3. 點擊 Generate API key（產生 API 金鑰）按鈕。
4. 複製出現的 API 金鑰，並將其貼到安全的地方，例如密碼管理器。
5. 點擊複製圖示以完成每個設定畫面，直到您看到 Finish & optimize（完成並最佳化）按鈕。點擊該按鈕以完成設定。
6. 完成後，Optimize 將自動在背景開始新的錄製工作階段。

2. 將 Optimize 新增至您的應用程式

2.1. 安裝所需的 Prisma Client 擴充功能

在終端機中執行以下指令以安裝必要的依賴套件

npm install @prisma/extension-optimize

2.2. 將 Optimize API 金鑰新增至您的 .env 檔案

複製 Prisma Optimize API 金鑰，並將其新增至您的 .env 檔案

OPTIMIZE_API_KEY="YOUR_OPTIMIZE_API_KEY"

2.3. 擴充您的 Prisma Client 執行個體

使用 Optimize 擴充功能來擴充您現有的 Prisma Client 執行個體

import { PrismaClient } from '../path/to/generated/prisma/client';
import { withOptimize } from "@prisma/extension-optimize";

const prisma = new PrismaClient().$extends(
  withOptimize({ apiKey: process.env.OPTIMIZE_API_KEY }),
).$extends(withAccelerate());

將 Optimize 擴充功能與其他擴充功能一起使用

由於 擴充功能會依序套用，請確保您以正確的順序套用它們。擴充功能無法共用行為，且最後套用的擴充功能優先級最高。

const prisma = new PrismaClient()
  .$extends(withOptimize())
  .$extends(withAccelerate())

2.5. 使用 Prisma Optimize 產生洞察分析

請遵循以下步驟開始使用 Prisma Optimize 產生查詢洞察分析

1. 執行您的應用程式，並在錄製功能啟用時執行一些 Prisma 查詢。

2. 在您的應用程式執行並根據已執行的 Prisma 查詢產生洞察分析後，點擊紅色的 Recording（錄製中）按鈕。

3. 點擊以瀏覽 個別查詢詳情，並查看 Recommendations（建議）分頁，以獲取任何能提升查詢效能的建議改進方案。

   資訊

   使用 Prisma AI 來理解建議，並在您的 Prisma 模型上下文中應用它們。

需要協助嗎？

如果您需要協助，請前往我們的 Discord 中的 #help-and-questions 頻道，或與 我們的社群 聯繫，看看其他人如何使用 Optimize。