通用

概覽

Prisma 控制檯使您能夠管理和配置使用 Prisma 資料平臺 (PDP) 產品的專案，並幫助您將其整合到您的應用程式中。

• Accelerate：透過全球資料庫快取和可擴充套件的連線池加速您的查詢。
• Optimize：為您提供可以幫助您加快資料庫查詢速度的建議。
• Prisma Postgres：一個為 Prisma ORM 最佳化的託管 PostgreSQL 資料庫。

概念

控制檯工作流基於四個主要概念

• 使用者賬戶：為了使用 PDP 產品，您需要擁有一個 PDP 使用者賬戶。一個使用者通常會建立一個使用者賬戶來管理其所有工作區、專案和環境。該使用者也可以被邀請加入其他工作區，以協作完成該工作區中的專案。
• 工作區：一個使用者賬戶可以屬於多個工作區。一個工作區通常代表一個團隊，其中包含協作處理一個或多個專案的個人。計費是在工作區級別進行的，即月末工作區的賬單會包含與給定工作區中專案相關的所有成本。
• 專案：一個專案屬於一個工作區。它通常代表團隊正在處理的應用程式或服務。
• 環境：一個環境屬於一個專案。它通常對映到開發階段，如開發、預生產或生產。API 金鑰在環境級別提供，產品也根據每個環境進行配置（例如，Accelerate 使用的資料庫連線字串）。

以下是這些概念之間如何關聯的視覺說明

使用者賬戶

使用者賬戶是與 PDP 產品進行任何互動的先決條件。您可以使用它來管理您的工作區（及其專案）。使用者賬戶也可以被邀請協作處理由其他使用者建立的工作區。

如果您需要刪除您的使用者賬戶，請轉到此處。

工作區

您可以建立多個工作區。工作區是用於託管專案的獨立空間。一個工作區可以關聯多個使用者賬戶，以便多個使用者可以協作處理該工作區中的專案。

在每個工作區中，您可以

• 檢視和管理該工作區中的所有專案（及其環境）。
• 管理賬單，即選擇訂閱計劃、配置支付方式或檢視賬單歷史記錄。
• 檢視該工作區中所有專案啟用的 PDP 產品的使用情況。
• 邀請其他使用者在工作區中協作。
• 訪問以衡量查詢效能並接收 AI 驅動的建議。

Optimize

您可以在您的 Prisma 控制檯工作區中訪問 Optimize。

訪問 Optimize 儀表板

要訪問所需工作區中的 Optimize 儀表板

1. 點選左側導航欄中的 Optimize 選項卡。
2. 點選 Generate API key 按鈕。

生成 Optimize API 金鑰

要獲取 Optimize API 金鑰

1. 導航到您想使用 Optimize 的工作區。
2. 確保 Optimize 已啟動。如果尚未啟動，請點選 Generate API key 按鈕。
3. 在 Optimize 中，點選導航欄右上角的個人資料名稱。
4. 選擇 Settings。
5. 點選 Create API key。
6. 在 Name 欄位中輸入 API 金鑰的名稱，然後點選 Create。
7. 複製 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 金鑰部分管理它們。