在 Bigtable 中创建和更新计数器

创建 Bigtable 实例

1. 使用 bigtable instances create 命令创建实例。

   gcloud bigtable instances create counters-quickstart-instance \
       --display-name="Counters quickstart instance" \
       --cluster-config=id="counters-quickstart-cluster",zone="us-east1-c"
   

连接到您的实例

1. 将 cbt CLI 配置为使用您的项目和实例，方法是创建一个 .cbtrc 文件。

   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 createtable 命令创建一个名为 counters_quickstart_table 且包含三个汇总列族的表。为每个列族配置不同的汇总类型：

   • 列族 max_family 的类型为 Max，输入类型为 Integer。
   • 列族 min_family 的类型为 Min，输入类型为 Integer。
   • 列族 sum_family 的类型为 Sum，输入类型为 Integer。

   cbt createtable counters_quickstart_table families=sum_family:never:intsum,min_family:never:intmin,max_family:never:intmax
   

2. 运行 cbt ls 命令，列出您的列族。

   cbt ls counters_quickstart_table
   

   该 shell 会显示类似如下所示的输出：

   Family Name     GC Policy
   -----------     ---------
   max_family      <never>
   min_family      <never>
   sum_family      <never>
   

在表格中创建计数器

1. 使用 cbt addtocell 命令，将初始值 5 写入三个列族中的每个新列，并使用行键 row-key1 和时间戳 0。此操作会创建汇总单元格，您可以将其用作计数器。

   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
   

读取数据

1. 如需将计数器值视为整数而非字节，请定义一个 yaml 文件，供 cbt CLI 用于设置输出格式。运行以下命令：

   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
   

   该 shell 会显示类似如下所示的输出。这些值采用整数格式，时间戳采用 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
   

3. 可选：在 Google Cloud 控制台中使用 SQL 查询表。

   1. 在 Google Cloud 控制台中，打开 Bigtable 实例页面。

      前往实例列表

   2. 从列表中选择 counters-quickstart-instance。

   3. 在导航菜单中，点击 Bigtable Studio。

   4. 点击 Editor（编辑器）标签页。

   5. 将以下查询粘贴到编辑器中：

      SELECT * FROM `counters_quickstart_table`
      

   6. 点击运行。查询结果会显示在结果表中，如下所示：

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