Data Connect 專案包含兩個主要基礎架構元素：
- 一或多個 Data Connect 服務執行個體
- 一或多個 PostgreSQL 適用的 Cloud SQL 執行個體
本指南將說明如何設定及管理 Data Connect 服務執行個體，並介紹如何管理相關聯的 Cloud SQL 執行個體。
設定 Firebase Data Connect 的區域
使用 Data Connect 的專案需要設定位置資訊。
建立新的 Data Connect 服務執行個體時，系統會提示您選取服務的位置。
服務地區
Data Connect 服務可在下列區域建立。
- asia-east1
- asia-east2
- asia-northeast1
- asia-northeast2
- asia-northeast3
- asia-south1
- asia-southeast1
- asia-southeast2
- australia-southeast1
- australia-southeast2
- europe-central2
- europe-north1
- europe-southwest1
- europe-west1
- europe-west2
- europe-west3
- europe-west4
- europe-west6
- europe-west8
- europe-west9
- me-west1
- northamerica-northeast1
- northamerica-northeast2
- southamerica-east1
- southamerica-west1
- us-central1
- us-east1
- us-east4
- us-south1
- us-west1
- us-west2
- us-west3
- us-west4
管理 Data Connect 服務執行個體
建立服務
如要建立新服務，請使用 Firebase 主控台，或使用 Firebase CLI 執行本機專案初始化作業。這些工作流程會建立新的 Data Connect 服務。
這些流程也會引導您完成下列操作：
- 佈建新的 Cloud SQL 執行個體 (免費等級)
- 將現有的 Cloud SQL 執行個體連結至 Data Connect (Blaze 方案)
管理使用者
Data Connect 提供工具，可依據最小權限原則 (授予每位使用者或服務帳戶所需的最低權限，以支援所需功能) 和角色式存取權控管 (RBAC) 概念 (使用預先定義的角色管理資料庫權限，簡化安全性管理) 管理使用者存取權。
如要將專案成員新增為可修改專案中 Data Connect 執行個體的使用者，請使用 Firebase 主控台選取適當的預先定義使用者角色。
這些角色會使用 Identity and Access Management (IAM) 授予權限。角色是一組權限。將角色指派給專案成員後，就會授予該專案成員該角色具備的所有權限。詳情請參閱：
選擇角色來啟用特定工作流程
IAM 角色可啟用 Firebase CLI 工作流程，讓您管理 Data Connect 專案。
| CLI 指令、其他工作流程 | 必要角色 |
|---|---|
firebase init dataconnect
|
|
firebase deploy -–only dataconnect
|
|
firebase dataconnect:sql:diff
|
|
firebase dataconnect:sql:migrate |
|
firebase dataconnect:sql:grant
|
|
監控 Data Connect 服務效能
瞭解服務效能
Data Connect 服務和 PostgreSQL 適用的 Cloud SQL 服務效能，可能會影響您在預先發布版期間的使用體驗。
- Data Connect 服務每分鐘的 GraphQL 和連接器要求數量上限為 1200 次，這會影響您呼叫及執行查詢和異動的頻率。
- 如需 PostgreSQL 適用的 Cloud SQL 服務的一般指引，請參閱 配額和限制說明文件。
監控服務效能、用量和帳單
您可以在 Firebase 控制台中監控要求、錯誤和作業率，包括全域和個別作業。
管理 Cloud SQL 執行個體
免費試用限制
免費試用版不支援下列 PostgreSQL 適用的 Cloud SQL 功能：
- 15.x 以外的 PostgreSQL 版本
- 使用現有的 PostgreSQL 適用 Cloud SQL 執行個體
- 與 db-f1-micro 不同的機器層級
- 變更執行個體的資源，例如儲存空間、記憶體和 CPU
- 唯讀備用資源
- 私人執行個體 IP 位址
- 高可用性 (多可用區)；僅支援單一可用區的執行個體
- Enterprise Plus 版
- 自動備份
- 自動增加儲存空間。
管理 Cloud SQL 執行個體
一般來說，您可以使用 Google Cloud 控制台管理 Cloud SQL 執行個體，執行下列工作流程。
- 停止及重新啟動 Cloud SQL 執行個體
- 建立及刪除 Cloud SQL 資料庫 (在執行個體內)
- 使用標記啟動 PostgreSQL 資料庫執行個體，並使用各種擴充功能
- 在 Google Cloud 控制台中使用 Cloud SQL 可觀察性功能監控效能
- 透過 IAM、密鑰管理工具、資料加密和授權 Proxy 等功能，管理 Cloud SQL 的存取權和安全性
- 新增、刪除及管理 Cloud SQL 使用者。
如需瞭解這些工作流程和其他工作流程，請參閱 PostgreSQL 適用的 Cloud SQL 說明文件。
使用 Firebase CLI 和 Google Cloud 工具授予 PostgreSQL 使用者角色
Data Connect 提供工具，可依據最小權限原則 (授予每位使用者或服務帳戶所需的最低權限，以支援所需功能) 和角色式存取權控管 (RBAC) 概念 (使用預先定義的角色管理資料庫權限，簡化安全性管理) 管理使用者存取權。
在某些情況下，您可能會想要透過所選的 SQL 用戶端 (例如 Cloud Run、Cloud Functions 或 GKE) 直接連線至 Data Connect 管理的 Cloud SQL 資料庫。
如要啟用這類連線，您必須授予 SQL 權限，方法如下：
- 將
roles/cloudsql.clientIAM 角色指派給需要連線至執行個體的使用者或服務帳戶，方法是透過 Google Cloud 控制台或使用 gcloud CLI - 使用 Firebase CLI 授予必要的 PostgreSQL 角色
指派 Cloud SQL IAM 角色
如要瞭解如何使用 PostgreSQL 適用的 Cloud SQL 指派 IAM 角色 roles/cloudsql.client，請參閱「角色和權限」。
授予 PostgreSQL 角色
您可以使用 Firebase CLI，透過 firebase dataconnect:sql:grant 指令，將預先定義的 PostgreSQL 角色授予與專案相關聯的使用者或服務帳戶。
舉例來說，如要授予寫入者角色，請在 CLI 中執行下列指令：
firebase dataconnect:sql:grant --role writer
詳情請參閱 CLI 參考指南。