通用
概述
该使您能够管理和配置使用 Prisma Data Platform (PDP) 产品的项目,并帮助您将其集成到您的应用程序中
- Accelerate:通过全局数据库缓存和可扩展连接池加快查询速度。
- Optimize:提供可帮助您加快数据库查询速度的建议。
- Prisma Postgres:一种为 Prisma ORM 优化的托管 PostgreSQL 数据库。
概念
控制台工作流程基于四个主要概念
- 用户账户:为了使用 PDP 产品,您需要拥有一个 PDP 用户账户。一个用户通常会创建一个用户账户来管理其所有工作区、项目和环境。该用户也可以被邀请加入其他工作区,以在该工作区中的项目上进行协作。
- 工作区:一个用户账户可以属于多个工作区。工作区通常代表一个由个人组成的团队,他们在一个或多个项目上协同工作。账单按工作区级别计费,即月末工作区的发票会涵盖与该工作区中项目相关的所有费用。
- 项目:项目属于工作区。它通常代表团队正在开发的应用程序或服务。
- 环境:环境属于项目。它通常映射到一个开发阶段,例如
Development
、Staging
或Production
。API 密钥在环境级别配置,产品也按环境进行配置(例如,用于 Accelerate 的数据库连接字符串)。
以下是这些概念如何相互关联的视觉图示
用户账户
用户账户是与 PDP 产品进行任何交互的先决条件。您可以使用它来管理您的工作区(及其项目)。用户账户也可以被邀请加入其他用户创建的工作区进行协作。
如果您需要删除您的用户账户,请点击此处。
工作区
您可以创建多个工作区。工作区是用于托管项目的独立空间。一个工作区可以关联多个用户账户,以便多个用户可以在该工作区中的项目上进行协作。
在每个工作区中,您可以
- 查看和管理该工作区中的所有项目(及其环境)。
- 管理账单,例如选择订阅计划、配置支付方式或查看发票历史记录。
- 查看该工作区中所有项目中已启用的 PDP 产品的使用情况。
- 邀请其他用户在工作区中进行协作。
- 访问,以衡量查询性能并接收由 AI 提供支持的建议。
Optimize
您可以在您的工作区中访问 Optimize。
访问 Optimize 控制面板
要在所需工作区中访问 Optimize 控制面板
- 点击左侧导航栏中的 Optimize 标签页。
- 点击 生成 API 密钥 按钮。
生成 Optimize API 密钥
获取 Optimize API 密钥的步骤
- 导航到您要使用 Optimize 的工作区。
- 确保 Optimize 已启动。如果未启动,请点击 生成 API 密钥 按钮。
- 在 Optimize 中,点击导航栏右上角的您的个人资料名称。
- 选择 设置。
- 点击 创建 API 密钥。
- 在 名称 字段中输入 API 密钥的名称,然后点击 创建。
- 复制 API 密钥并安全存储。这将通过
"OPTIMIZE_API_KEY"
在您项目的.env
文件中使用。最后,点击 “我已安全存储” 按钮。
您现在已获得 Optimize API 密钥。
项目
在每个工作区中,您可以创建多个项目。项目通常代表一个应用程序(产品或服务)。每个项目通常有一个Prisma schema。
在每个项目,您可以
- 查看和管理该项目中的所有环境。
您可以在工作区中创建的项目数量取决于该工作区配置的订阅计划。
环境
环境是用于为特定项目提供 PDP 产品的独立空间。环境通常对应于开发阶段,例如 Development
、Staging
或 Production
。每个新项目都以一个名为 Production
的默认环境开始。默认环境确保项目始终至少有一个活动环境。除非将另一个环境指定为默认环境,否则无法删除默认环境。
在每个环境,您可以
- 启用、禁用和配置 PDP 产品(Optimize、Accelerate 等)。
- 生成 API 密钥。
- 对于 Accelerate
- 设置您的数据库连接字符串。
- 配置 Accelerate 连接池运行的区域。
- 更改连接池大小。
- 配置查询持续时间和查询响应大小限制。
- 启用静态 IP。
您可以在项目中创建的环境数量取决于工作区中配置的订阅计划。
数据库连接管理
项目环境左侧面板中的数据库标签页允许您配置和管理与远程数据库的连接。在此标签页中,连接部分显示一个包含以下列的表格
列名 | 描述 |
---|---|
提示 | 提供正在使用的数据库的 URL 结构。 |
静态 IP | 指示数据库和关联产品是否启用了静态 IP。 |
产品 | 列出使用该数据库 URL 启用的产品。 |
操作 | 允许您禁用所有活动产品并移除连接。 |
账单
您在工作区中选择的订阅计划决定了您可以在该工作区中创建多少项目和环境
Starter | Pro | Business | Enterprise | |
---|---|---|---|---|
项目 | 5 | 60 | 180 | 自定义 |
环境 | 2 / 项目 | 6 / 项目 | 12 / 项目 | 自定义 |
数据库 | 10 | 60 | 180 | 自定义 |
按工作区计费
账单按工作区设置
- 每个工作区选择一个订阅计划。这意味着一个用户账户可以属于多个工作区,每个工作区使用不同的计划。
- 每个工作区选择一个支付方式。这意味着一个用户账户可以属于多个工作区,每个工作区有不同的支付方式。
在计费周期结束时,您选择的支付方式将被收取该工作区中所有项目(及其环境)的产品产生的费用。
您可以在工作区的账单部分配置所有账单详情。
按比例计费
所有基础计划价格都按比例计算,这意味着您只需为您订阅特定计划的持续时间付费。此外,您还需要为您在订阅期间产生的任何使用费付费。
例如
- 如果您在某月的第 15 天订阅我们的 Pro 计划,您将只按当月剩余天数收取基础计划价格。
- 如果您在 30 天的某月中订阅 10 天后降级计划(例如从 Business 降级到 Pro),您将按 Business 计划的基础价格支付 10 天的费用,并按 Pro 计划的基础价格支付 20 天的费用。
访问我们的定价页面了解更多详情。
降级订阅计划
如果您降级订阅计划,可能需要删除部分项目和/或其环境,以便符合新选择计划的限制。
例如,如果您的工作区使用 Business 计划,并且当前有 14 个(共 15 个)项目,则您需要至少删除 4 个项目才能满足 Pro 计划的项目限制。此外,您还需要确保剩余项目每个项目不超过 6 个环境,以符合 Pro 计划的环境限制。
您还需要禁用 Pro 或 Business 计划独有的功能,例如静态 IP。完成这些调整(包括禁用静态 IP)后,即可继续降级订阅计划。
通过平台 CLI 进行编程访问
除了控制台的 Web 界面之外,Prisma CLI 还提供另一种与您的 PDP 账户交互和管理 PDP 产品的方式。
如果您需要编程访问,例如将其集成到 CI 工作流程中,这会很有用。
阅读更多关于Prisma CLI 的信息。
API 密钥
需要 API 密钥来验证您的 Prisma Client 对 Prisma Accelerate 和 Prisma Optimize 等产品的请求。
您可以为每个环境生成多个 API 密钥,并在环境的API 密钥部分管理这些密钥。