Bigtable

Bigtable 連接器可讓您對 Bigtable 資料執行插入、刪除、更新和讀取作業。

支援的版本

這個連接器支援 Google Bigtable 第 2 版。

事前準備

使用 Bigtable 連接器前，請先在 Google Cloud 專案中完成下列步驟：

• 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
• 將 roles/connectors.admin IAM 角色授予設定連結器的使用者。
• 將 roles/secretmanager.viewer 和 roles/secretmanager.secretAccessor IAM 角色授予要用於連接器的服務帳戶。
• 啟用下列服務：
  • secretmanager.googleapis.com (Secret Manager API)
  • connectors.googleapis.com (Connectors API)

  如要瞭解如何啟用服務，請參閱「啟用服務」。如果專案先前未啟用這些服務或權限，系統會在您設定連接器時提示啟用。

設定連接器

連線專屬於資料來源。也就是說，如果有多個資料來源，您必須為每個資料來源建立個別的連結。如要建立連結，請按照下列步驟操作：

1. 在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。

   前往「連線」頁面

2. 按一下「+ 建立新連線」，開啟「建立連線」頁面。
3. 在「位置」部分中，選擇連線的位置。
   1. 區域：從下拉式清單中選取位置。

      如需所有支援區域的清單，請參閱「地點」一文。

   2. 點按「下一步」。
4. 在「連線詳細資料」部分，完成下列步驟：
   1. 連接器：從可用連接器的下拉式清單中選取「Bigtable」。
   2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
   3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。

      連線名稱必須符合下列條件：

      • 連線名稱可使用英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱開頭須為英文字母，結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個半形字元。
   4. 視需要輸入連線執行個體的「Description」(說明)。
   5. 或者，可啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為 Error。
   6. 服務帳戶：選取具備必要角色的服務帳戶。
   7. 專案 ID：包含 Bigtable 執行個體的專案 ID。
   8. 執行個體 ID：Bigtable 執行個體 ID。
   9. 連線集區大小：Bigtable 連線集區大小。
   10. 視需要設定「連線節點設定」：
       • 節點數下限：輸入連線節點的數量下限。
       • 節點數上限：輸入連線節點數上限。

       節點是用來處理交易的連線單位 (或備用資源)。如要處理更多連線交易，就需要更多節點；反之，如要處理較少的交易，則需要較少的節點。如要瞭解節點對連線器價格的影響，請參閱「 連線節點的定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。

   注意：只有預付方案客戶可以自訂連線節點值。
   11. (選用) 按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
   12. 點按「下一步」。
5. 在「Authentication」(驗證) 部分，輸入驗證詳細資料。
   1. 選取「驗證類型」，然後輸入相關詳細資料。

      Bigtable 連線支援下列驗證類型：

      • 服務帳戶驗證
      • OAuth 2.0 - 授權碼

   如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

   2. 點按「下一步」。
6. 檢查：檢查連結和驗證詳細資料。
7. 點選「建立」。

設定驗證機制

根據要使用的驗證方式輸入詳細資料。

• 服務帳戶驗證：請確認服務帳戶具備必要的角色。

• OAuth 2.0 - 授權碼
  • 用戶端 ID：應用程式提供的用戶端 ID。
  • 範圍：所需範圍清單
  • 用戶端密鑰：Secret Manager 密鑰，內含應用程式的用戶端密鑰。
  • 密鑰版本：上方所選密鑰的密鑰版本。
  設定第三方 OAuth 應用程式時，請使用這個已授權的重新導向 URI (回呼網址)：

  https://console.cloud.google.com//connectors/oauth?project=PROJECT_ID

  將 PROJECT_ID 替換為 Google Cloud 專案 ID。

連線設定範例

本節列出建立連線時設定的各個欄位範例值。

服務帳戶驗證連線類型

欄位名稱	詳細資料
位置	asia-east1
版本	1
連接器	bigtable
連接器版本	1
連線名稱	googlecloud-bigtable-service-authontication
服務帳戶	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
專案 ID	PROJECT_ID
執行個體 ID	gcloud-bigtable-instance
連線集區大小	1
節點數量下限	2
節點數量上限	50
用戶端密鑰	bigtable-client-secret
Secret 版本	1

OAuth 2.0 - 授權碼連線類型

欄位名稱	詳細資料
位置	asia-east1
版本	1
連接器	bigtable
連接器版本	1
連線名稱	bigtable-oauth
服務帳戶	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
專案 ID	PROJECT_ID
執行個體 ID	googlecloud-bigtable-instance
連線集區大小	1
節點數量下限	2
節點數量上限	50
用戶端密鑰	bigtable-client-secret
Secret 版本	1

系統限制

每個節點的 Bigtable 連接器每秒最多可處理 16 筆交易，超過此限制的交易都會遭到節流。根據預設，Integration Connectors 會為連線分配 2 個節點 (提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。

注意：整合連接器節點的數量會根據用量自動動態調整。不過，如要為大量資料預留容量，不必等待自動調度資源，可以調整連線的節點數量下限。如要處理連線的更多交易，需要更多節點。反之，如果連線處理的交易較少，則需要的節點也較少。如要設定節點值，請按照下列步驟操作：

• 如果您是即付即用方案客戶，請在編輯連線頁面中設定節點的最小值和最大值。
• 如果您是訂閱型客戶，請與支援團隊聯絡。

節點可處理的最大交易量取決於各種因素。因此，建議您先檢查後端系統是否已完成最佳化設定，可處理所需流量，再調整節點下限以提升處理量。

在整合中建立 Bigtable 連線

建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。

• 如要瞭解如何在 Apigee Integration 中建立及使用連接器工作，請參閱「連接器工作」。
• 如要瞭解如何在 Application Integration 中建立及使用連接器工作，請參閱「連接器工作」。

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。

注意：您可以在「連線器」工作中，查看連線器的實體、作業和動作。

• 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義與連接器對連接器不同。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱連線器工作中的實體作業。 不過，如果連接器不支援任何實體作業，Operations 清單就不會列出這類不支援的作業。

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

注意： 所有實體和動作都會有相關聯的結構定義。舉例來說，動作結構定義會包含參數詳細資料，例如參數名稱和對應的資料類型。連線會在執行階段從後端擷取實體和動作的結構定義 (中繼資料)。如果架構有任何更新，現有連線不會自動反映這些更新，您必須手動重新整理架構。如要重新整理連線的結構定義，請開啟連線的「連線詳細資料」頁面，然後按一下「重新整理連線結構定義」。

實體作業範例

本節說明如何在這個連接器中執行部分實體作業。

範例 - 從資料表取得記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Table。
3. 選取 Get 作業，然後按一下「完成」。
4. 將實體 ID 設為「Get Operation」(取得作業)。如要設定實體 ID，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」， 然後在「輸入值」欄位中輸入 row99，並選擇 EntityId 做為本機變數。

範例 - 列出資料表中的所有記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Table。
3. 選取 List 作業，然後按一下「完成」。

範例 - 在資料表中建立記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities and select Table2。
2. 選取 Create 作業，然後按一下「完成」。
3. 將 RowKey 設為「建立」作業。如要設定 RowKey，請在「資料對應」的「資料對應工具」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 ，並為資料欄系列提供 RowKey 和 Payload 做為本機變數。

範例 - 更新資料表中的記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities and select Table。
2. 選取 Update 作業，然後按一下「完成」。
3. 將實體 ID 設為「更新」作業。如要設定實體 ID，請在「資料對應」的「資料對應工具」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 ，並為資料欄系列提供 RowKey 和酬載做為本機變數。

範例 - 從資料表刪除記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities and select Table2。
2. 選取 Delete 作業，然後按一下「完成」。
3. 將實體 ID 設為 Delete 作業。如要設定實體 ID，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 row99，並選擇 EntityId 做為本機變數。

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連接器，請前往 Cloud 論壇的 Google Cloud 社群。

後續步驟

• 瞭解如何暫停及恢復連線。
• 瞭解如何監控連接器用量。
• 瞭解如何查看連結器記錄。