管理 Data Connect 服務和資料庫

Data Connect 專案包含兩個主要基礎架構元素：

• 一或多個 Data Connect 服務執行個體
• 一或多個 PostgreSQL 適用的 Cloud SQL 執行個體

本指南將說明如何設定及管理 Data Connect 服務執行個體，並介紹如何管理相關聯的 Cloud SQL 執行個體。

設定 Firebase Data Connect 的區域

使用 Data Connect 的專案需要設定位置資訊。

建立新的 Data Connect 服務執行個體時，系統會提示您選取服務的位置。

注意： Data Connect 服務的位置不會影響您專案中其他 Firebase 產品所需的位置選項，例如預設 Cloud Firestore 位置。

服務地區

Data Connect 服務可在下列區域中建立。

注意： PostgreSQL 適用的 Cloud SQL 執行個體必須與相關聯的 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 的 Vertex AI 整合功能不支援在下列環境中部署的 PostgreSQL 適用 CloudSQL 執行個體：

• asia-northeast2
• asia-southeast2
• australia-southeast2
• northamerica-northeast2
• southamerica-west1
• us-west2
• us-west3

管理 Data Connect 服務執行個體

建立服務

如要建立新服務，請使用 Firebase 控制台，或使用 Firebase CLI 執行本機專案初始化作業。這些工作流程會建立新的 Data Connect 服務。

這些流程也會引導您完成下列操作：

• 佈建新的 Cloud SQL 執行個體 (免費等級)
• 將現有的 Cloud SQL 執行個體連結至 Data Connect (Blaze 方案)

注意： PostgreSQL 適用的 Cloud SQL 執行個體必須與相關聯的 Data Connect 執行個體位於相同位置。如果您的應用程式需要位於多個地區的 Cloud SQL 執行個體，Firebase CLI 可協助將相同的結構定義、查詢和變異型部署至各個地區的許多資料連結服務。

管理使用者

Data Connect 提供工具，可依據最小權限原則 (授予每位使用者或服務帳戶所需的最低權限，以支援所需功能) 和角色式存取權控管 (RBAC) 概念 (使用預先定義的角色管理資料庫權限，簡化安全性管理) 管理使用者存取權。

如要將專案成員新增為可修改專案中 Data Connect 執行個體的使用者，請使用 Firebase 主控台選取適當的預先定義使用者角色。

注意： Data Connect 服務和 PostgreSQL 適用的 Cloud SQL 是 Data Connect 專案的不同元件。您可以分別管理各個元件。舉例來說，您可以新增具有刪除結構定義權限的 Data Connect 使用者，但這不會授予他們執行 PostgreSQL 資料庫備份作業的權限。

這些角色會使用 Identity and Access Management (IAM) 授予權限。角色是一組權限。將角色指派給專案成員後，就會授予該專案成員該角色具備的所有權限。詳情請參閱：

• Firebase IAM 角色總覽
• Data Connect 角色的詳細清單

選擇角色來啟用特定工作流程

IAM 角色可啟用 Firebase CLI 工作流程，讓您管理 Data Connect 專案。

CLI 指令、其他工作流程	必要角色
firebase init dataconnect	沒有權限 (未連結 Cloud SQL 執行個體) roles/cloudsql.admin (建立 Cloud SQL 執行個體時)
firebase deploy -–only dataconnect	firebasedataconnect.connectors.* firebasedataconnect.services.* firebasedataconnect.schemas.* roles/cloudsql.admin
firebase dataconnect:sql:diff	firebasedataconnect.services.* firebasedataconnect.schemas.*
firebase dataconnect:sql:migrate	目標 Cloud SQL 執行個體的 roles/cloudsql.admin
firebase dataconnect:sql:grant	目標 Cloud SQL 執行個體的 roles/cloudsql.admin

監控 Data Connect 服務效能

瞭解服務效能

Data Connect 服務和 PostgreSQL 適用的 Cloud SQL 服務的效能都會影響您的使用體驗。

• 如需 PostgreSQL 適用的 Cloud SQL 服務的一般指引，請參閱 配額和限制說明文件。

• Data Connect 服務設有 GraphQL 要求配額，會影響您呼叫及執行查詢的頻率：

  • 每個專案的整體配額為每分鐘 6000 個用戶端應用程式連接器要求。
  • 每個專案的整體配額為每分鐘 6000 個要求，來自 Firebase Admin SDK 和 REST API。
  • 每位使用者每分鐘 1,200 個要求的配額。這裡的「每位使用者」是指限制適用於由單一 IP 位址啟動的要求，無論是來自用戶端應用程式、Firebase Admin SDK 或 REST API。

  如果您遇到這些配額限制，請與 Firebase 支援團隊聯絡，調整相關配額。

監控服務效能、用量和帳單

您可以在 Firebase 控制台中監控要求、錯誤和作業率，包括全域和個別作業。

管理 Cloud SQL 執行個體

免費試用限制

3 個月免費試用方案不支援下列 PostgreSQL 適用的 Cloud SQL 功能：

• 15.x 以外的 PostgreSQL 版本
• 使用現有的 PostgreSQL 適用 Cloud SQL 執行個體
• 與 db-f1-micro 不同的機器層級
• 變更執行個體的資源，例如儲存空間、記憶體和 CPU
• 唯讀備用資源
• 私人執行個體 IP 位址
• 高可用性 (多可用區)；僅支援單一可用區的執行個體
• Enterprise Plus 版
• 自動備份
• 自動增加儲存空間。

管理 Cloud SQL 執行個體

一般來說，您可以使用 Google Cloud 控制台管理 Cloud SQL 執行個體，執行下列工作流程。

注意： Data Connect 服務和 PostgreSQL 適用的 Cloud SQL 是 Data Connect 專案的不同元件。您可以分別管理各個元件。舉例來說，您可以新增 Cloud SQL 使用者，授予他們處理 PostgreSQL 管理工作 (例如效能監控和備份) 的權限，但不會授予他們修改 Data Connect 執行個體的權限。

• 停止及重新啟動 Cloud SQL 執行個體
• 建立及刪除 Cloud SQL 資料庫 (在執行個體內)
• 使用標記啟動 PostgreSQL 資料庫執行個體，並使用各種擴充功能
• 在 Google Cloud 控制台中使用 Cloud SQL 可觀察性功能監控效能
• 透過 IAM、密鑰管理工具、資料加密和授權 Proxy 等功能，管理 Cloud SQL 的存取權和安全性
• 新增、刪除及管理 Cloud SQL 使用者。

如需瞭解這些工作流程和其他工作流程，請參閱 PostgreSQL 適用的 Cloud SQL 說明文件。

授予 PostgreSQL 使用者角色

Data Connect 提供工具，可依據最小權限原則 (授予每位使用者或服務帳戶所需的最低權限，以支援所需功能) 和角色式存取權控管 (RBAC) 概念 (使用預先定義的角色管理資料庫權限，簡化安全性管理) 管理使用者存取權。

在某些情況下，您可能會想要透過所選的 SQL 用戶端 (例如 Cloud Run、Cloud Functions 或 GKE) 直接連線至 Data Connect 管理的 Cloud SQL 資料庫。

如要啟用這類連線，您必須授予 SQL 權限，方法如下：

• 將 roles/cloudsql.client IAM 角色指派給需要連線至執行個體的使用者或服務帳戶，方法是透過 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 參考指南。

整合現有的 PostgreSQL 適用 Cloud SQL 資料庫

預設資料庫佈建和管理工作流程會假設您的專案使用新的 (未開發) 資料庫，當您叫用 firebase deploy 時，Data Connect 會顯示要進行的資料庫結構定義變更，並在您核准後執行任何遷移作業。

對於現有 (舊場地) 資料庫，您可能會自行建立管理結構定義的工作流程，且無法使用 Data Connect 工具進行遷移作業，但仍想在 Data Connect 專案中使用資料庫，以便利用其 SDK 產生功能，針對行動裝置和網站進行開發、以查詢為基礎的授權、用戶端連線管理等。

本節將說明後者：將現有資料庫與 Data Connect 整合。

注意： 本文假設您已建立 PostgreSQL 適用的 CloudSQL 資料庫，並設定資料庫管理員的使用者角色。如果您有要遷移至 Cloud SQL 的 PostgreSQL 資料庫，可以按照這份 PostgreSQL 適用的 Cloud SQL 指南

使用資料庫移轉服務

將現有資料庫整合至 Data Connect 專案

整合現有資料庫的工作流程通常包含下列步驟：

1. 在 Firebase 主控台的 Data Connect 專案設定期間，選取執行個體和資料庫。

2. 使用 Firebase CLI 執行 firebase dataconnect:sql:setup 指令，並拒絕讓 Data Connect 處理 SQL 遷移作業的選項。

   為避免資料庫結構定義發生非自訂工具驅動的變更，setup 指令會指派適當的讀取者和寫入者角色，但不會指派 owner 角色。如要進一步瞭解 setup 指令和 PostgreSQL 角色，請參閱 CLI 參考指南。

3. 撰寫符合資料庫結構定義的 Data Connect GraphQL 結構定義。

   只有在 GraphQL 結構定義與 PostgreSQL 結構定義相容時，才能部署 GraphQL 結構定義、查詢和異動。

   為簡化兩個結構定義的對齊作業，我們提供 firebase dataconnect:sql:diff 指令，可提供遷移資料庫所需的 SQL 陳述式。您可以使用這項功能，逐步調整 GraphQL 結構定義，以符合現有資料庫結構定義。

4. 日後，您可以在本機開發環境中快速疊代 GraphQL 結構定義、查詢和異動。滿意後，您可以使用 firebase dataconnect:sql:diff 取得 SQL 遷移陳述式，然後使用自訂工具和流程套用至 PostgreSQL。

5. 或者，您也可以先直接對 PostgreSQL 資料庫進行變更，然後嘗試將這些變更匯入 GraphQL 結構定義。我們建議採用 GraphQL 優先的方法，因為在某些情況下，系統可能不支援結構定義變更。此外，如果您部署的變更會導致 PostgreSQL 結構定義與已部署的連接器查詢或變異不相容，這些連接器可能會停止運作或發生異常。