通用

概述

这个使您能够管理和配置使用 Prisma Data Platform (PDP) 产品的项目，并帮助您将它们集成到您的应用程序中

• 加速 (Accelerate)：通过具有可扩展连接池的全局数据库缓存来加速您的查询。
• 脉冲 (Pulse)：使您能够构建事件驱动和实时的应用程序，让您以类型安全的方式流式传输数据库更改事件。
• 优化 (Optimize)：为您提供可以帮助您更快地进行数据库查询的建议。
• Prisma Postgres：一种为 Prisma ORM 优化的托管 PostgreSQL 数据库。

概念

控制台工作流程基于四个主要概念

• 用户帐户 (User account)：为了使用 PDP 产品，您需要拥有一个 PDP 用户帐户。一个用户通常会创建一个用户帐户来管理他们所有的工作区、项目和环境。用户也可以被邀请加入其他工作区，以协作处理该工作区中的项目。
• 工作区 (Workspaces)：一个用户帐户可以属于多个工作区。一个工作区通常代表一个团队，该团队的成员一起工作在一个或多个项目上。账单是在工作区级别进行的，即，一个月结束时的工作区发票会记录与给定工作区中项目相关的所有成本。
• 项目 (Projects)：一个项目属于一个工作区。它通常代表一个团队正在开发的应用程序或服务。
• 环境 (Environments)：一个环境属于一个项目。它通常映射到一个开发阶段，例如 Development、Staging 或 Production。API 密钥是在环境级别配置的，产品也是按环境配置的（例如，用于加速 (Accelerate) 的数据库连接字符串）。

这是一个关于这些概念如何相互关联的可视化图示

用户帐户 (User account)

用户帐户是与 PDP 产品进行任何交互的先决条件。您可以使用它来管理您的工作区（及其项目）。用户帐户也可以被邀请协作处理其他用户创建的工作区。

如果您需要删除您的用户帐户，请访问这里。

工作区 (Workspace)

您可以创建多个工作区。工作区是一个隔离的空间，用于托管项目。一个工作区可以关联多个用户帐户，以便多个用户可以协作处理工作区中的项目。

在每个工作区中，您可以

• 查看和管理该工作区中的所有项目（及其环境）。
• 管理账单，即选择订阅计划，配置付款方式，或查看发票历史记录。
• 查看您启用的 PDP 产品在工作区中所有项目中的使用情况。
• 邀请其他用户在工作区中进行协作。
• 访问以衡量查询性能并接收 AI 驱动的建议。

优化 (Optimize)

您可以在您的工作区内访问优化 (Optimize)。

访问优化 (Optimize) 仪表板

要在您想要的工作区中访问优化 (Optimize) 仪表板

1. 单击左侧导航栏上的 优化 (Optimize) 选项卡。
2. 单击 启动优化 (Launch Optimize) 按钮。

生成优化 (Optimize) API 密钥

要获取优化 (Optimize) API 密钥

1. 导航到您想要使用优化 (Optimize) 的工作区。
2. 确保优化 (Optimize) 已启动。如果未启动，请单击 启动优化 (Launch Optimize) 按钮。
3. 在优化 (Optimize) 中，单击导航栏右上角的您的个人资料名称。
4. 选择 设置 (Settings)。
5. 单击 创建 API 密钥 (Create API key)。
6. 在 名称 (Name) 字段中输入 API 密钥的名称，然后单击 创建 (Create)。
7. 复制 API 密钥并安全地存储它。这将通过 "OPTIMIZE_API_KEY" 在您项目的 .env 文件 中使用。最后，单击 “我已经安全地存储了它 (I've stored it securely)” 按钮。

您现在拥有了您的优化 (Optimize) API 密钥。

项目 (Project)

在每个工作区中，您可以创建多个项目。一个项目通常代表一个应用程序（产品或服务）。您通常每个项目有一个 Prisma schema。

在每个项目中，您可以

• 查看和管理该项目中的所有环境。

您可以在工作区中创建的项目数量取决于在该工作区中配置的订阅计划。

环境 (Environment)

环境是用于为特定项目配置 PDP 产品的隔离空间。环境通常对应于开发阶段，例如 Development、Staging 或 Production。每个新项目都以名为 Production 的默认环境开始。默认环境确保项目始终至少有一个活动环境。除非另一个环境被指定为默认环境，否则无法删除它。

在每个环境中，您可以

• 启用、禁用和配置 PDP 产品（脉冲 (Pulse)、加速 (Accelerate) 等）。
• 生成 API 密钥。
• 对于加速 (Accelerate)
  • 设置您的数据库连接字符串。
  • 配置加速 (Accelerate) 的连接池运行的区域。
  • 更改连接池大小。
  • 配置查询持续时间和查询响应大小限制。
  • 启用静态 IP。
• 对于脉冲 (Pulse)
  • 设置您的数据库连接字符串（Pulse 兼容数据库的）。
  • 配置脉冲 (Pulse) 运行的区域。
  • 配置数据库复制。
  • 启用静态 IP。

您可以在项目中创建的环境数量取决于在您的工作区中配置的订阅计划。

数据库连接管理

项目环境左侧面板中的 数据库 (Database) 选项卡允许您配置和管理与远程数据库的连接。在此选项卡中，连接 (Connections) 部分显示一个表格，其中包含以下列

列名	描述
提示	提供正在使用的数据库的 URL 结构。
静态 IP (Static IP)	指示是否为数据库和关联产品启用了静态 IP (Static IP)。
产品	列出使用数据库 URL 启用的产品。
操作	允许您禁用所有活动产品并删除连接。

账单 (Billing)

您在工作区中选择的订阅计划决定了您可以在该工作区中创建多少项目和环境

	入门版 (Starter)	专业版 (Pro)	商务版 (Business)	企业版 (Enterprise)
项目	5	60	180	自定义
环境	每个项目 2 个	每个项目 6 个	每个项目 12 个	自定义
数据库	10	60	180	自定义

按工作区计费 (Per-workspace billing)

账单是在每个工作区的基础上设置的

• 订阅计划是按工作区选择的。这意味着，一个用户帐户可以属于多个工作区，其中每个工作区使用不同的计划。
• 付款方式是按工作区选择的。这意味着，一个用户帐户可以属于多个工作区，其中每个工作区具有不同的付款方式。

在一个计费期结束时，您选择的付款方式将被收取该工作区中所有项目（及其环境）的产品所产生的费用。

您可以在工作区的 账单 (Billing) 部分配置所有账单详细信息。

按比例计费 (Prorated billing)

所有基本计划价格均按比例计算，这意味着您只需为您订阅特定计划的持续时间付费。此外，您还需要为您在订阅期间产生的任何使用费用付费。

例如

• 如果您在一个月的第 15 天订阅了我们的 专业版 (Pro) 计划，您将仅被收取该月剩余天数的基本计划价格。
• 如果您在一个 30 天的月份的 10 天后降级您的订阅计划（例如，从 商务版 (Business) 降级到 专业版 (Pro)），您将被收取 10 天的 商务版 (Business) 计划的基本价格和 20 天的 专业版 (Pro) 计划的基本价格。

访问我们的定价页面以获取更多详细信息。

降级订阅计划 (Downgrading a subscription plan)

如果您降级订阅计划，您可能需要删除您的一些项目和/或其环境，以便遵守新选择的计划的限制。

例如，如果您的工作区使用的是 商务版 (Business) 计划，并且目前有 14 个（共 15 个）项目，您将需要删除至少 4 个项目，以遵守 专业版 (Pro) 计划的项目限制。此外，您需要确保剩余的项目每个项目不超过 6 个环境，以遵守 专业版 (Pro) 计划的环境限制。

您还需要禁用 专业版 (Pro) 或 商务版 (Business) 计划专有的功能，例如静态 IP (Static IPs)。一旦进行了这些调整，包括禁用静态 IP (Static IPs)，您就可以继续降级您的订阅计划。

通过平台 CLI 进行程序化访问 (Programmatic access via the Platform CLI)

除了控制台 (Console) 的 Web 界面之外，Prisma CLI 还提供了另一种与您的 PDP 帐户交互和管理 PDP 产品的方式。

如果您需要程序化访问，例如将其集成到 CI 工作流程中，这将非常有用。

阅读更多关于 Prisma CLI 的信息。

API 密钥 (API keys)

需要 API 密钥来验证来自您的 Prisma Client 到产品（例如 Prisma 加速 (Accelerate) 和 Prisma 脉冲 (Pulse)）的请求。

API 密钥不是特定于产品的，这意味着在同一环境中使用时，您可以将相同的 API 密钥用于加速 (Accelerate) 和脉冲 (Pulse)。

您可以在每个环境中生成多个 API 密钥，并通过环境中的 API 密钥 (API Keys) 部分管理这些密钥。