在 Bigtable 中建立及更新計數器

建立 Bigtable 執行個體

連線至執行個體

1. 建立 .cbtrc 檔案，將 cbt CLI 設為使用您的專案和執行個體。

   echo project = PROJECT_ID >> ~/.cbtrc && echo instance = counters-quickstart-instance >> ~/.cbtrc
   

   將 PROJECT_ID 替換為您使用的專案 ID。

2. 確認您已正確設定 .cbtrc 檔案。

   cat ~/.cbtrc
   

   終端機會顯示 .cbtrc 檔案的內容，類似於下列內容：

   project = PROJECT_ID
   instance = counters-quickstart-instance

   現在您可以使用 cbt CLI 搭配執行個體。

建立含有匯總資料欄系列的資料表

在表格中建立計數器

1. 使用 cbt addtocell 指令，在三個資料欄系列中各寫入一個新資料欄，並使用 row-key1 做為資料列索引鍵，0 做為時間戳記，初始值為 5。這項作業會建立匯總儲存格，做為計數器使用。

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=5@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=5@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=5@0
   

讀取資料

您可以在 Cloud de Confiance 控制台中以 SQL 查詢資料表，或使用 cbt CLI 讀取資料。

在 Cloud de Confiance 控制台中以 SQL 查詢資料表

1. 在 Cloud de Confiance 控制台中，開啟「Bigtable instances」(Bigtable 執行個體) 頁面。

   前往執行個體清單

2. 從清單中選取 counters-quickstart-instance。

3. 在導覽選單中，按一下「Bigtable Studio」。

4. 按一下「編輯器」分頁標籤。

5. 請將這項查詢貼到編輯器：

   SELECT * FROM `counters_quickstart_table`
   

6. 按一下「執行」。查詢結果會顯示在「結果」表格中，如下所示：

   _key	max_family	min_family	sum_family
   row-key1	{ "max_column": 5 }	{ "min_column": 5 }	{ "sum_column": 5 }

使用 cbt CLI 讀取

1. 如要以整數而非位元組的形式查看計數器值，請定義 cbt CLI 可用來格式化輸出的 YAML 檔案。執行以下指令：

   echo "families:" > ~/cbtformat.yaml
   echo "  max_family:" >> ~/cbtformat.yaml
   echo "    default_encoding: BigEndian" >> ~/cbtformat.yaml
   echo "    default_type: INT64" >> ~/cbtformat.yaml
   echo "  min_family:" >> ~/cbtformat.yaml
   echo "    default_encoding: BigEndian" >> ~/cbtformat.yaml
   echo "    default_type: INT64" >> ~/cbtformat.yaml
   echo "  sum_family:" >> ~/cbtformat.yaml
   echo "    default_encoding: BigEndian" >> ~/cbtformat.yaml
   echo "    default_type: INT64" >> ~/cbtformat.yaml
   

2. 確認您已正確設定 cbtformat.yaml 檔案。

   cat ~/cbtformat.yaml
   

   終端機會顯示 cbtformat.yaml 檔案的內容，類似於下列內容：

   families:
     max_family:
       default_encoding: BigEndian
       default_type: INT64
     min_family:
       default_encoding: BigEndian
       default_type: INT64
     sum_family:
       default_encoding: BigEndian
       default_type: INT64
   

3. 使用 cbt read 指令傳遞 YAML 檔案，並讀取您在資料表中新增的資料。現在表格有三欄，每欄的匯總類型都不同。

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   殼層的輸出內容大致如下。值會格式化為整數，時間戳記則採用世界協調時間 (UTC) 格式。

   row-key1
     max_family:max_column                    @ 1970/01/01-00:00:00.000000
       5
     min_family:min_column                    @ 1970/01/01-00:00:00.000000
       5
     sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
       5
   

更新計數器

1. 使用建立儲存格時相同的時間戳記，在表格的每個資料欄中新增值 3。在每個資料欄中，系統會根據儲存格的匯總類型，將儲存格值與現有值合併。

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=3@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=3@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=3@0
   

2. 再次使用 cbt read 指令讀取資料表中的資料。每個儲存格現在都包含匯總值。

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   sum_column 包含 5 和 3 的總和 (8)，min_column 包含寫入其中的兩個值中較小的值 (3)，而 max_column 包含寫入其中的兩個值中較大的值 (5)。

   row-key1
     max_family:max_column                    @ 1970/01/01-00:00:00.000000
       5
     min_family:min_column                    @ 1970/01/01-00:00:00.000000
       3
     sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
       8