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