設定變更串流

如要追蹤 Bigtable 資料表中的資料異動，可以為資料表啟用變更串流，然後使用 Dataflow 等應用程式讀取變更串流。閱讀本文之前，請先參閱變更串流總覽。特別是串流變更時產生的費用。

本頁說明如何啟用、停用及變更變更串流的保留期限。

如要瞭解如何建立啟用變更串流的新資料表，請參閱建立資料表。

必要角色

如要取得啟用、停用或修改 Bigtable 變更串流所需的權限，請要求管理員授予下列 IAM 角色。

  • Bigtable 系統管理員 (roles/bigtable.admin) 須位於包含您要串流變更的資料表所在的 Bigtable 執行個體中

啟用變更串流

如要在現有資料表上啟用變更串流，請完成下列步驟：

主控台

  1. 在 Google Cloud 控制台中開啟 Bigtable 執行個體清單。

    開啟執行個體清單

  2. 按一下要啟用變更串流的執行個體。

  3. 按一下左側窗格中的 [Tables] (資料表)。

    「Tables」(資料表) 頁面會顯示執行個體中的資料表清單。

  4. 找出要啟用變更串流的表格，然後按一下「編輯」。

  5. 按一下「啟用變更串流」。

  6. 在「到期時間」欄位中輸入 1 到 7 之間的數字，設定資料串流記錄的保留天數。

  7. 按一下 [儲存]。

gcloud

如要在資料表上啟用變更串流，請使用 gcloud bigtable instances tables update 指令。

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

更改下列內容：

  • TABLE_ID：您要串流變更的資料表 ID
  • INSTANCE_ID：包含資料表的例項
  • PROJECT_ID：包含執行個體的專案
  • CHANGE_STREAM_RETENTION_PERIOD：Bigtable 應保留資料表變更串流資料的時間長度。必須介於 1 天到 7 天之間，並以數字和單位字母表示。可接受的單位包括天 (d)、小時 (h)、分鐘 (m) 和秒 (s)。範例：5d

停用變更串流

您隨時可以停用資料表的變更串流。停用變更串流前建立的資料串流記錄會繼續佔用儲存空間，直到下次壓縮為止，但您不必再支付這類儲存空間的費用。停用變更串流後，您就無法讀取變更串流，包括停用串流前記錄的變更。

主控台

  1. 在 Google Cloud 控制台中開啟 Bigtable 執行個體清單。

    開啟執行個體清單

  2. 按一下您要查看其資料表的執行個體。

  3. 按一下左側窗格中的 [Tables] (資料表)。

    「Tables」(資料表) 頁面會顯示執行個體中的資料表清單。

  4. 找到要停用變更串流設定的表格，然後按一下「編輯」。

  5. 取消勾選「啟用變更串流」。

  6. 按一下 [儲存]。

gcloud

如要停用資料表的變更串流，請使用 gcloud bigtable instances tables update 指令。

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --clear-change-stream-retention-period

更改下列內容：

  • TABLE_ID：您要串流變更的資料表 ID
  • INSTANCE_ID：包含資料表的例項
  • PROJECT_ID：包含執行個體的專案

修改變更串流的保留時間

您可以修改 Bigtable 保留變更串流記錄的天數。如果減少天數，設定變更前串流的記錄仍會繼續佔用儲存空間，直到下次壓縮為止。設定變更後，您只能串流新指定時間範圍內的變更。

如果延長保留時間，系統不會追溯保留時間，而是從您修改設定時起，將變更串流保留更長的時間。

主控台

  1. 在 Google Cloud 控制台中開啟 Bigtable 執行個體清單。

    開啟執行個體清單

  2. 按一下您要查看其資料表的執行個體。

  3. 按一下左側窗格中的 [Tables] (資料表)。

    「Tables」(資料表) 頁面會顯示執行個體中的資料表清單。

  4. 找到要修改變更串流設定的表格，然後按一下「編輯」。

  5. 在「到期時間」欄位中，輸入 1 到 7 之間的數字，代表要保留資料串流記錄的天數。

  6. 按一下 [儲存]。

gcloud

如要變更資料表變更串流的保留期限，請使用 gcloud bigtable instances tables update 指令。

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

更改下列內容：

  • TABLE_ID：要串流變更的資料表 ID
  • INSTANCE_ID：包含資料表的例項
  • PROJECT_ID：包含執行個體的專案
  • CHANGE_STREAM_RETENTION_PERIOD：Bigtable 應保留資料表變更串流資料的時間長度。必須介於 1 到 7 天，並以數字和字母表示單位。可接受的單位包括天 (d)、小時 (h)、分鐘 (m) 和秒 (s)。範例：5d

後續步驟