创建实例并使用 cbt CLI 写入数据

如果您想要了解 Bigtable，可以通过逐步完成快速入门中的操作来了解在生产环境中广泛使用的基础知识。

在本快速入门中，您将执行以下操作：

连接到 Bigtable 实例。
执行基本管理任务。
将数据写入表中。
从表中读取数据。

准备工作

登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

安装 Google Cloud CLI。

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

创建或选择 Google Cloud 项目。

选择或创建项目所需的角色

选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
创建项目：如需创建项目，您需要拥有 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予角色。

创建 Google Cloud 项目：
```
gcloud projects create PROJECT_ID
```
将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。
选择您创建的 Google Cloud 项目：
```
gcloud config set project PROJECT_ID
```
将 PROJECT_ID 替换为您的 Google Cloud 项目名称。

验证是否已为您的 Google Cloud 项目启用结算功能。

启用 Cloud Bigtable 和 Cloud Bigtable Admin API：

启用 API 所需的角色

如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

向您的用户账号授予角色。对以下每个 IAM 角色运行以下命令一次： roles/bigtable.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

替换以下内容：

PROJECT_ID：您的项目 ID。
USER_IDENTIFIER：您的用户账号的标识符。例如，myemail@example.com。
ROLE：您授予用户账号的 IAM 角色。

安装 Google Cloud CLI。

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

创建或选择 Google Cloud 项目。

选择或创建项目所需的角色

选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
创建项目：如需创建项目，您需要拥有 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予角色。

创建 Google Cloud 项目：
```
gcloud projects create PROJECT_ID
```
将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。
选择您创建的 Google Cloud 项目：
```
gcloud config set project PROJECT_ID
```
将 PROJECT_ID 替换为您的 Google Cloud 项目名称。

验证是否已为您的 Google Cloud 项目启用结算功能。

启用 Cloud Bigtable 和 Cloud Bigtable Admin API：

启用 API 所需的角色

如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

向您的用户账号授予角色。对以下每个 IAM 角色运行以下命令一次： roles/bigtable.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

替换以下内容：

PROJECT_ID：您的项目 ID。
USER_IDENTIFIER：您的用户账号的标识符。例如，myemail@example.com。
ROLE：您授予用户账号的 IAM 角色。

运行以下命令以安装 cbt CLI：
```
gcloud components install cbt
```

创建 Bigtable 实例。

在 Google Cloud 控制台中打开创建实例页面。

创建实例
在实例名称部分，输入 Quickstart instance。
在实例 ID 部分，输入 quickstart-instance。
点击继续。
在存储类型部分，选择 SSD。
点击继续。
在集群 ID 部分，输入 quickstart-instance-c1。
在区域部分，选择您附近的一个区域。
在可用区部分，选择任何。
在节点扩缩模式部分，选择手动分配。
在数量部分，选择 1。
点击创建以创建实例。

连接到您的实例

将 cbt CLI 配置为使用您的项目和实例，方法是创建一个 .cbtrc 文件，并将 PROJECT_ID 替换为在其中创建了 Bigtable 实例的项目的 ID：
```
echo project = PROJECT_ID >> ~/.cbtrc && echo instance = quickstart-instance >> ~/.cbtrc
```
验证 .cbtrc 文件的设置是否正确：
```
cat ~/.cbtrc
```
终端会显示 .cbtrc 文件的内容，如下所示：
```
project = PROJECT_ID
instance = quickstart-instance
```
现在，您可以使用 cbt CLI 来处理您的实例了。

读取和写入数据

Bigtable 将数据存储在表中。这些表包含行，且每行由一个行键标识。

行中的数据以“列族”（即一组列）的形式整理。 “列限定符”用于标识列族中的单个列。

行和列的交集处可能会有多个包含时间戳的单元。

创建一个名为 my-table 的表。
```
cbt createtable my-table
```
列出您的表：
```
cbt ls
```
该命令会显示类似如下所示的输出：
```
    my-table
```
添加一个名为 cf1 的列族：
```
cbt createfamily my-table cf1
```

列出您的列族：

cbt ls my-table

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

    Family Name     GC Policy
    -----------     ---------
    cf1             <never>

将 test-value1 和 test-value2 值写入到 r1 行中，且所属列族为 cf1，列限定符为 c1：
```
cbt set my-table r1 cf1:c1=test-value1
  cbt set my-table r1 cf1:c1=test-value2
```
使用 cbt read 命令读取您已添加到表中的数据：
```
cbt read my-table
```
该 shell 会显示类似如下所示的输出：
```
    ----------------------------------------
    r1
      cf1:c1                                   @ 2023/03/22-06:56:11.323000
        "test-value1"
      cf1:c1                                   @ 2023/03/22-06:56:04.361000
        "test-value2"
```
系统会为 r1 行中的同一列存储两个带有时间戳的值。

注意：在本快速入门中，您只需设置两个单元，不过 Bigtable 允许您在单个写入请求中设置最多 10,000 个单元。

清理

为避免系统因本快速入门中使用的资源向您的 Google Cloud 账号收取费用，请删除您的实例。删除 .cbtrc 文件后，您就可以开始处理其他项目了。

删除 my-table 表：
```
cbt deletetable my-table
```
删除实例：
```
cbt deleteinstance quickstart-instance
```
删除 .cbtrc 文件：
```
rm ~/.cbtrc
```
（可选）使用 gcloud CLI 撤消凭据：
```
gcloud auth revoke
```

后续步骤

浏览 Bigtable Codelab。
查看 cbt CLI 参考文档。
请参阅欺诈侦查用例的示例源代码。
使用 C#、C++、Go、Java、Node.js、PHP、Python、Ruby 编写 Hello World 应用，或使用Java 版 HBase 客户端。