一般
總覽
The使您能夠管理與設定使用 Prisma Data Platform (PDP) 產品的專案，並協助您將其整合至您的應用程式中。
- Accelerate：透過具有可擴展連線池的全球資料庫快取，加速您的查詢。
- Optimize：提供優化建議，協助您提升資料庫查詢效能。
- Prisma Postgres：專為 Prisma ORM 優化的託管式 PostgreSQL 資料庫。
概念
Console 的工作流程基於四個主要概念：
- 使用者帳戶 (User account)：若要使用 PDP 產品，您需要擁有一個 PDP 使用者帳戶。使用者通常會建立一個使用者帳戶來管理其所有的工作區、專案與環境。使用者也可以受邀加入其他工作區，以協作該工作區內的專案。
- 工作區 (Workspaces)：一個使用者帳戶可以屬於多個工作區。工作區通常代表一個共同執行一個或多個專案的團隊。計費是以工作區為單位，亦即月底的工作區帳單會包含該工作區內所有專案產生的相關費用。
- 專案 (Projects)：專案屬於一個工作區。它通常代表團隊正在開發的應用程式或服務。
- 環境 (Environments)：環境屬於一個專案。它通常對應到開發階段，例如
Development（開發）、Staging（測試）或Production（正式環境）。API 金鑰是在環境層級進行配置的，產品也是針對各個環境分別設定（例如：用於 Accelerate 的資料庫連線字串）。
以下是這些概念之間關係的視覺化說明：
使用者帳戶
使用者帳戶是與 PDP 產品進行任何互動的先決條件。您可以使用它來管理您的工作區（及其專案）。使用者帳戶也可以受邀協作由其他使用者建立的工作區。
如果您需要刪除您的使用者帳戶，請前往這裡。
工作區
您可以建立多個工作區。工作區是一個隔離的空間，用於託管專案。一個工作區可以關聯多個使用者帳戶，以便多位使用者能夠在該工作區內的專案上進行協作。
在每個工作區中，您可以：
- 檢視並管理該工作區中的所有專案（及其環境）。
- 管理帳單，例如選擇訂閱方案、設定付款方式或檢視發票記錄。
- 檢視該工作區內所有專案中已啟用 PDP 產品的使用量。
- 邀請其他使用者在工作區內進行協作。
- 存取：以衡量查詢效能並接收 AI 驅動的建議。
資料庫指標
您可以在單一工作區中託管多個資料庫。在每個資料庫中，您可以檢視關於資料庫運作效能的詳細報告，其中包含多種指標，例如：
- 平均回應大小
- 平均查詢時長
- 總流出流量 (Egress)
- 總操作次數 (Total operations)
- 快取利用率 (Cache utilization)
Optimize
您可以在您的工作區中存取 Optimize。
存取 Optimize 儀表板
若要存取您所需工作區中的 Optimize 儀表板：
- 點擊左側導覽列的 Optimize 分頁。
- 點擊 Generate API key（產生 API 金鑰）按鈕。
產生 Optimize API 金鑰
若要取得 Optimize API 金鑰：
- 導覽至您想要使用 Optimize 的工作區。
- 確保 Optimize 已啟動。若尚未啟動，請點擊 Generate API key 按鈕。
- 在 Optimize 中，點擊導覽列右上角的個人檔案名稱。
- 選擇 Settings（設定）。
- 點擊 Create API key（建立 API 金鑰）。
- 在 Name（名稱）欄位中為 API 金鑰輸入名稱，然後點擊 Create（建立）。
- 複製並安全地儲存該 API 金鑰。此金鑰將用於您專案的
.env檔案中，變數名稱為"OPTIMIZE_API_KEY"。最後，點擊 "I've stored it securely"（我已安全儲存）按鈕。
現在您已擁有 Optimize API 金鑰。
專案
在每個工作區中，您可以建立多個專案。專案通常代表一個應用程式（產品或服務）。通常每個專案會有一個 Prisma Schema。
在每個專案中，您可以：
- 檢視並管理該專案中的所有環境。
您在工作區中可以建立的專案數量取決於該工作區所設定的訂閱方案。
環境
環境是一個隔離的空間，用於為特定專案部署 PDP 產品。環境通常對應到開發階段，例如 Development、Staging 或 Production。每個新專案都會從一個名為 Production 的預設環境開始。預設環境可確保專案始終至少有一個活動的環境。除非指定另一個環境作為預設值，否則無法刪除該環境。
在每個環境中，您可以：
- 啟用、停用與設定 PDP 產品（Optimize、Accelerate 等）。
- 產生 API 金鑰。
- 針對 Accelerate：
- 設定您的資料庫連線字串。
- 設定 Accelerate 連線池運作的地區 (region)。
- 變更連線池大小。
- 設定查詢執行時間與查詢回應大小的限制。
- 啟用固定 IP (Static IP)。
您在專案中可以建立的環境數量取決於您工作區所設定的訂閱方案。
資料庫連線管理
專案環境左側面板中的 Database（資料庫）分頁，讓您可以設定並管理與遠端資料庫的連線。在此分頁中，Connections（連線）區段會顯示一個包含以下欄位的表格：
| 欄位名稱 | 描述 |
|---|---|
| 提示 | 提供所使用資料庫的 URL 結構。 |
| 靜態 IP (Static IP) | 顯示資料庫及其相關產品是否已啟用固定 IP。 |
| 產品 | 列出使用該資料庫 URL 所啟用的產品。 |
| 動作 | 允許您停用所有活動產品並移除該連線。 |
計費
您在工作區中選擇的訂閱方案決定了您在該工作區中可以建立的資料庫數量。
| 免費版 | 入門版 | 專業版 | 商業版 | 企業版 | |
|---|---|---|---|---|---|
| 資料庫 | 5 | 10 | 100 | 1000 | 客製化 |
工作區計費
計費設定是以工作區為單位：
- 訂閱方案是依工作區選定的。這意味著一個使用者帳戶可以屬於多個工作區，且每個工作區可以使用不同的方案。
- 付款方式是依工作區選定的。這意味著一個使用者帳戶可以屬於多個工作區，且每個工作區可以有不同的付款方式。
在計費週期結束時，您所選的付款方式將會被扣除該工作區內所有專案（及其環境）所產生的費用。
您可以在工作區的 Billing（帳單）區段中設定所有計費詳細資訊。
按比例計費
所有基礎方案費用均按比例計算，這意味著您只需支付訂閱該特定方案期間的費用。此外，您還需支付在訂閱期間產生的任何使用費用。
例如
- 如果您在每個月的第 15 天訂閱我們的 Pro 方案，您只需支付該月中剩餘天數的基礎方案費用。
- 如果您在 30 天月份的第 10 天後降級您的訂閱方案（例如從 Business 降級為 Pro），您將需支付 10 天的 Business 方案基礎費用，以及 20 天的 Pro 方案基礎費用。
請瀏覽我們的定價頁面以了解更多詳細資訊。
降級訂閱方案
如果您降級訂閱方案，您可能需要刪除部分專案和/或其環境，以符合新選擇方案的限制。
例如，如果您的工作區目前採用 Business 方案並擁有 14 個專案（上限為 15 個），您將需要刪除至少 4 個專案以符合 Pro 方案的專案上限。此外，您必須確保剩餘專案中，每個專案的環境不超過 6 個，以符合 Pro 方案的環境上限。
您還需要停用 Pro 或 Business 方案獨有的功能，例如固定 IP。完成這些調整（包括停用固定 IP）後，您即可進行降級。
透過 Platform CLI 進行程式化存取
除了 Console 的網頁介面外，Prisma CLI 也提供了另一種與您的 PDP 帳戶互動並管理 PDP 產品的方式。
如果您需要程式化存取（例如整合至 CI 工作流程中），這將非常有用。
閱讀更多關於 Prisma CLI 的資訊。
API 金鑰
若要驗證從 Prisma Client 發送至 Prisma Accelerate 與 Prisma Optimize 等產品的請求，需要使用 API 金鑰。
您可以在每個環境中產生多個 API 金鑰，並透過環境中的 API Keys（API 金鑰）區段進行管理。