设置

先决条件

在开始使用 Prisma Optimize for Prisma Postgres 之前，请确保您具备以下条件：

• 一、.
• 使用 Prisma Client 版本 5.0.0 或更高版本（我们建议使用最新版本）的项目。
• 一个 Prisma Postgres 数据库。

注意

Prisma Optimize 适用于本地环境。欲了解更多信息，请参阅常见问题解答。

1. 启动 Optimize

1. 登录您的.
2. 点击左侧导航栏中的 Optimize 选项卡。
3. 点击 生成 API 密钥 按钮。
4. 复制显示的 API 密钥并将其粘贴到安全的地方，例如密码管理器。
5. 点击复制图标，继续浏览每个设置屏幕，直到看到 完成并优化 按钮。点击该按钮完成设置。
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 查询生成洞察后，点击红色的 录制 按钮。

3. 通过点击单个查询详细信息，并查看 推荐 选项卡，了解任何建议的改进以提高查询性能。

   信息

   使用 Prisma AI 理解推荐并在您的 Prisma 模型上下文中应用它们。

需要帮助？

如果您需要帮助，请在我们的 Discord 的 #help-and-questions 频道联系我们，或者与我们的社区联系，了解其他人如何使用 Optimize。