创建和管理表

控制台

要在实例中创建新表，请执行以下操作：

1. 在 Cloud de Confiance 控制台中，打开 Bigtable 实例列表。

   打开实例列表

2. 点击要查看其表的实例。

3. 在左侧窗格中，点击表。

   表页面显示实例中的表列表。

4. 点击 add_box 创建表。

5. 输入表 ID。

6. 可选：添加列族。

   您可以现在添加列，也可以稍后添加。表必须至少有一个列族才能向其中写入数据或从中读取变更数据流。

7. 可选：为表启用变更数据流。在启用变更数据流之前，请务必了解影响，包括存储费用和应用配置文件使用需求增多。如需查看这些详细信息，请参阅变更数据流概览。

   1. 选择启用变更数据流。

   2. 在保留时间字段中，输入一个介于 1 到 7 之间的数字，以指定变更数据流数据应保留的天数。

8. 可选：如果您不希望 Bigtable 每天创建表的备份，请清除启用自动备份复选框。如需了解详情，请参阅使用自动备份。

9. 可选：启用表的低频访问，作为分层存储（预览版）的一部分：

   1. 选择启用分层存储。

   2. 在老化阈值字段中，输入一个天数，表示 Bigtable 在经过该天数后将数据从 SSD 存储空间移至不常访问的存储空间。该数字必须大于或等于 30。

10. 可选，企业 Plus 版：默认情况下，系统会在表的实例中的所有集群中创建每日备份。如需选择 Bigtable 必须每天备份相应表的集群，请在选择要备份的集群字段中选择集群位置。 如需了解详情，请参阅配置自动备份集群位置。

11. 可选：如需配置行键架构，请选择定义行键架构，然后执行以下操作：

    1. 在编码列表中，为行键架构选择一种编码类型。

    2. 如果您选择了 DelimitedBytes，请在定界符字段中输入用于分隔现有行键中的段的定界符。默认值为井号 (#)。

    3. 在细分字段中，输入细分的名称，例如 device_type。

    4. 在类型列表中，选择行键段的数据类型。

    5. 根据所选的数据类型，在字节编码列表中，保留行键区段的默认编码类型或更改该类型。

    6. 可选：如果您的行键区段包含多个部分，请点击添加行键区段以添加其他字段。

12. 点击创建。

gcloud

如需创建表格，请运行以下命令。如需查看选项的完整列表，请参阅 gcloud bigtable instances tables create。

gcloud bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN-FAMILIES

替换以下内容：

• TABLE_ID：新表的唯一 ID
• INSTANCE_ID：实例的 ID
• PROJECT_ID：将包含新表的项目
• COLUMN-FAMILIES：列族名称的英文逗号分隔列表。您可以稍后添加更多列族。

可选：

• 要防止表被删除，请在命令中附加 --deletion-protection。如果您未应用此设置，则可以删除表。您还可以通过附加 --no-deletion-protection 来明确允许删除表。

• 如需为表启用变更数据流，请为变更数据流数据指定保留期限。在启用变更数据流之前，请务必了解影响，包括存储费用和应用配置文件使用需求增多。如需查看这些详细信息，请参阅变更数据流概览。

  --change-stream-retention-period=RETENTION_PERIOD
  

  将 RETENTION_PERIOD 替换为 Bigtable 应将表的变更数据流数据保留的时长。时间必须介于 1 到 7 天之间。可接受的单位包括天 (d)、小时 (h)、分钟 (m) 和秒 (s)。示例：48h 或 6d

• 如需让 Bigtable 每天创建表的备份，并将每个备份保留默认保留期限（7 天），请在创建表时使用 --enable-automated-backup 标志。

  gcloud bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --column-families=COLUMN-FAMILIES \
      --enable-automated-backup
  

  如需配置其他保留期限，请使用 --automated-backup-retention-period 标志，而不是 --enable-automated-backup 标志，并提供不超过 90 天的值。该值必须以数字加上 m、h 或 d 单位（分钟、小时或天）表示，例如 15d 表示 15 天。

  企业 Plus 版：默认情况下，系统会在表的实例中的所有集群中创建每日备份。如需配置 Bigtable 必须在哪些集群位置创建表的每日备份，请使用 --automated-backup-locations 标志，而不是 --enable-automated-backup 标志。提供以英文逗号分隔的集群位置列表，必须在这些位置启用自动备份。示例： us-central1-a,us-east1-b,europe-west1-c。

• 如需启用不频繁访问存储空间作为分层存储（预览版）的一部分，请使用
  --tiered-storage-infrequent-access-older-than 标志，并将 AGE_THRESHOLD 替换为至少 30 天的值。可接受的单位包括天 (d)、小时 (h)、分钟 (m) 和秒 (s)。示例：32d 或 32d12h。

  gcloud beta bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD
  

cbt

使用以下命令，将 TABLE_NAME 替换为您的表名。您无法使用 cbt CLI 创建启用了变更数据流的表。

cbt createtable TABLE_ID

可选：如需在表中创建汇总列族，请在列族名称后附加汇总类型。以下命令会创建一个汇总列族，其垃圾回收政策为 never。

cbt createtable TABLE_ID families=FAMILY_NAME:never:TYPE

替换以下内容：

• TABLE_ID：新表的唯一 ID
• FAMILY_NAME：列族名称的英文逗号分隔列表。您可以稍后添加更多列族。
• TYPE：汇总类型。必须为 intsum、intmin、intmax 或 inthll。

控制台

使用Cloud de Confiance 控制台创建表时不能预拆分行。

gcloud

如需按行键拆分表，请运行以下命令。如需查看选项的完整列表，请参阅 gcloud bigtable instances tables create。

gcloud bigtable instances tables create TABLE_ID\
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN-FAMILIES \
    --splits=SPLITS

替换以下内容：

• TABLE_ID：新表的唯一 ID
• INSTANCE_ID：实例的 ID
• PROJECT_ID：将包含新表的项目
• COLUMN-FAMILIES：列族名称的英文逗号分隔列表。您可以稍后添加更多列族。
• SPLITS：最初应拆分表所按的行键，例如 10,20。

cbt

如需根据行键预拆分表，请使用以下语法创建表。将 [TABLE_NAME] 替换为表名称，并将 [SPLITS] 替换为要在预拆分中使用的行键前缀的逗号分隔列表。

```none
cbt createtable [TABLE_NAME] splits=[SPLITS]
```

例如，如需使用以 10 和 20 开头的行键预拆分 my-table 表，请运行以下命令：

```none
cbt createtable my-table splits=10,20
```

控制台

向新表中添加列族

1. 在创建表窗格中，针对要添加的每个列族，点击添加列族。

2. 在列族名称字段中，输入列族的唯一标识符。

3. 选择列族类型：

   • 标准：创建由垃圾回收政策管理的标准列族。
   • Aggregate：创建一个在写入时自动汇总数据的列族。您可以配置特定于聚合的垃圾回收政策，以管理数据保留政策，例如时间桶。

4. 如果您选择了聚合，请在聚合器字段中选择以下选项之一：

   • 总和：汇总所有单元格值的总和。
   • 最小值：汇总最小单元格值。
   • 最大值：汇总最大单元格值。
   • HyperLogLog：汇总单元格值的近似基数。

5. 为列族设置垃圾回收政策。

6. 点击完成。

向现有表添加列族

1. 在 Cloud de Confiance 控制台中，打开 Bigtable 实例列表。

   打开实例列表

2. 点击要查看其表的实例。

3. 在左侧窗格中，点击表。

   表页面显示实例中的表列表。

4. 点击要修改的表的 edit 修改。

5. 对于要添加的每个列族，请执行以下操作：

   1. 点击添加列族。
   2. 在列族名称字段中，输入列族的唯一标识符。

   3. 选择列族类型：

      • 标准：创建由垃圾回收政策管理的标准列族。
      • Aggregate：创建一个在写入时自动汇总数据的列族。您可以配置特定于聚合的垃圾回收政策，以管理数据保留政策，例如时间桶。

   4. 如果您选择了汇总，请在聚合器字段中选择以下选项之一：

      • 总和：汇总所有单元格值的总和。
      • 最小值：汇总最小单元格值。
      • 最大值：汇总最大单元格值。
      • HyperLogLog：汇总单元格值的近似基数。

   5. 为列族设置垃圾回收政策。

   6. 点击完成。

6. 点击保存。

gcloud

您无法使用 gcloud CLI 向表中添加列族。

cbt

如需向表添加列族，请使用以下命令：

cbt createfamily TABLE_ID FAMILY_NAME

例如，如要向 my-table 表中添加 cf1 和 cf2 列族，请使用以下命令：

cbt createfamily my-table cf1
cbt createfamily my-table cf2

可选：如需向表中添加汇总列族，请在列族名称后附加汇总类型。以下命令会创建一个具有聚合列族的表，该列族的垃圾回收政策为 never。

cbt createfamily TABLE_ID FAMILY_NAME:never:TYPE

替换以下内容：

• TABLE_ID：表 ID
• FAMILY_NAME：：列族名称的英文逗号分隔列表。您可以稍后添加更多列族。
• TYPE：聚合类型。必须为 intsum、intmin、intmax 或 inthll。

控制台

1. 在 Cloud de Confiance 控制台中，打开 Bigtable 实例列表。

   打开实例列表

2. 点击要查看其表的实例。

3. 在左侧窗格中，点击表。

   表页面显示实例中的表列表。

4. 点击要修改的表的 edit 修改。

5. 对于要删除的每个列族，完成以下操作：

   1. 将鼠标悬停在要删除的列族所在的行上。
   2. 点击 delete。

6. 点击保存。

7. 如需确认您了解删除列族是永久性操作，并且列族中的所有数据都将被删除，请在文本字段中输入“删除列族”。

8. 点击确认。

gcloud

您无法使用 gcloud CLI 从表中删除列族。

cbt

如需从表中删除列族，请使用以下命令，并将 [TABLE_NAME] 和 [FAMILY_NAME] 分别替换为表名称和列族名称：

cbt deletefamily [TABLE_NAME] [FAMILY_NAME]

例如，如需从 my-table 表中删除 cf2 列族，请运行以下命令：

cbt deletefamily my-table cf2

控制台

要查看实例中的表列表，请执行以下操作：

1. 在 Cloud de Confiance 控制台中，打开 Bigtable 实例列表。

   打开实例列表

2. 点击要查看其表的实例。

3. 在左侧窗格中，点击表。

   表页面显示实例中的表列表。

   • 点击表 ID 旁边的箭头以展开表复制列表。
   • 点击表名旁边的查看指标，即可查看该表的系统分析洞见数据。

gcloud

如需查看表列表，请运行 gcloud bigtable instances tables list 命令。

gcloud bigtable instances tables list --instances=INSTANCE_IDS

替换以下内容：

• INSTANCE_IDS：以英文逗号分隔的实例 ID 列表。

cbt

如需查看实例中的表列表，请运行以下命令：

    cbt ls INSTANCE_ID

替换以下内容：

• INSTANCE_ID：实例的永久性标识符。

C++

namespace cbt = ::google::cloud::bigtable;
namespace cbta = ::google::cloud::bigtable_admin;
using ::google::cloud::StreamRange;
[](cbta::BigtableTableAdminClient admin, std::string const& project_id,
   std::string const& instance_id) {
  std::string instance_name = cbt::InstanceName(project_id, instance_id);

  google::bigtable::admin::v2::ListTablesRequest r;
  r.set_parent(instance_name);
  r.set_view(google::bigtable::admin::v2::Table::NAME_ONLY);

  StreamRange<google::bigtable::admin::v2::Table> tables =
      admin.ListTables(std::move(r));
  for (auto& table : tables) {
    if (!table) throw std::move(table).status();
    std::cout << table->name() << "\n";
  }
}

C#

// Lists tables in intance.
// Initialize request argument(s).
ListTablesRequest request = new ListTablesRequest
{
    ParentAsInstanceName = s_instanceName
};
try
{
    // Make the request.
    PagedEnumerable<ListTablesResponse, Table> response = bigtableTableAdminClient.ListTables(request);

}
catch (Exception ex)
{
    Console.WriteLine($"Error listing tables {ex.Message}");
}

Java

// Lists tables in the current instance.
try {
  String parent = "projects/" + projectId + "/instances/" + instanceId;
  ListTablesRequest request = ListTablesRequest.newBuilder().setParent(parent).build();
  for (Table table : adminClient.listTables(request).iterateAll()) {
    System.out.println(table.getName());
  }
} catch (NotFoundException e) {
  System.err.println("Failed to list tables from a non-existent instance: " + e.getMessage());
}

Node.js

// List tables in current project
const [tables] = await adminClient.listTables({parent: instance.name});
tables.forEach(table => {
  console.log(table.name);
});

PHP

use Google\Cloud\Bigtable\Admin\V2\Client\BigtableInstanceAdminClient;
use Google\Cloud\Bigtable\Admin\V2\Client\BigtableTableAdminClient;
use Google\Cloud\Bigtable\Admin\V2\ListTablesRequest;

/**
 * List tables in an instance
 *
 * @param string $projectId The Google Cloud project ID
 * @param string $instanceId The ID of the Bigtable instance
 */
function list_tables(
    string $projectId,
    string $instanceId
): void {
    $instanceAdminClient = new BigtableInstanceAdminClient();
    $tableAdminClient = new BigtableTableAdminClient();

    $instanceName = $instanceAdminClient->instanceName($projectId, $instanceId);

    printf('Listing Tables:' . PHP_EOL);
    $listTablesRequest = (new ListTablesRequest())
        ->setParent($instanceName);
    $tables = $tableAdminClient->listTables($listTablesRequest)->iterateAllElements();
    $tables = iterator_to_array($tables);
    if (empty($tables)) {
        print('No table exists.' . PHP_EOL);
        return;
    }
    foreach ($tables as $table) {
        print($table->getName() . PHP_EOL);
    }
}

Python

tables = instance.list_tables()
print("Listing tables in current project...")
if tables != []:
    for tbl in tables:
        print(tbl.table_id)
else:
    print("No table exists in current project...")

Ruby

# instance_id = "my-instance"
bigtable.tables(instance_id).all.each do |t|
  puts "Table: #{t.name}"
end

控制台

要查看表的相关信息，请执行以下操作：

1. 在 Cloud de Confiance 控制台中，打开 Bigtable 实例列表。

   打开实例列表

2. 点击要查看其表的实例。

3. 在左侧窗格中，点击表。

   表页面显示实例中的表列表。 对于每个表， Cloud de Confiance 控制台会显示存储该表的集群数量、表的状态、存储空间利用率以及表的任何当前备份的标识符。对于启用了分层存储（预览版）的表，您可以查看 SSD 存储空间利用率和非频繁访问存储空间利用率。

4. 如需查看表的列族名称，请点击 edit。如需关闭修改表窗格，请点击取消。

5. 如需查看有关表的其他详细信息（包括表级层指标和复制状态），请点击表的名称。

gcloud

如需查看表的相关信息，请运行 gcloud bigtable instances tables describe 命令。

gcloud bigtable instances tables describe TABLE_ID \
    --instance=INSTANCE_ID

替换以下内容：

• TABLE_ID：表的唯一 ID
• INSTANCE_ID：实例的 ID

cbt

您可以使用 cbt CLI 获取表中现有列族的列表。

使用以下命令，将 [TABLE_NAME] 替换为表名称：

cbt ls [TABLE_NAME]

控制台

1. 在 Cloud de Confiance 控制台中，打开 Bigtable 实例列表。

   打开实例列表

2. 点击要查看其表的实例。

3. 在左侧窗格中，点击表。

   表页面显示实例中的表列表。

4. 点击要删除的表的 more_vert。

5. 点击删除。

6. 如需确认此操作将从实例的所有集群中删除该表，并且只能在七天内恢复删除的表，请在删除表框中输入表 ID。

7. 点击删除。

gcloud

1. 如需删除表，请运行 gcloud bigtable instances tables delete 命令。

   gcloud bigtable instances tables delete TABLE_ID --instance=INSTANCE_ID
   

   替换以下内容：

   • TABLE_ID：表的唯一 ID
   • INSTANCE_ID：实例的 ID

2. 在终端中，输入 y 以确认删除表。

cbt

如需删除表，请使用以下命令，并将 [TABLE_NAME] 替换为表名称：

cbt deletetable [TABLE_NAME]

控制台

1. 在 Cloud de Confiance 控制台中，打开 Bigtable 实例列表。

   打开实例列表

2. 点击要查看其表的实例。

3. 在左侧窗格中，点击表。

   表页面显示实例中的表列表。

4. 点击表 ID 旁边的 more_vert。

5. 如需启用防删除保护，请点击防止删除。如需停用防删除保护，请点击启用删除。只有有效选项才可见。

gcloud

如需为表启用防删除保护，请运行 gcloud bigtable instances table update 命令：

```sh
gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --deletion-protection
```

如需为表停用防删除保护，请运行以下命令：

```sh
gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --no-deletion-protection
```

请替换以下内容：

+ TABLE_ID: the unique identifier for the table
+ INSTANCE_ID: the ID of the instance

cbt

您无法使用 cbt CLI 启用或停用删除防护。

控制台

1. 在 Cloud de Confiance 控制台中，打开 Bigtable 实例列表。

   打开实例列表

2. 点击要查看其表的实例。

3. 在左侧窗格中，点击表。

   表页面显示实例中的表列表。

4. 点击要修改的表的 edit 修改。

5. 在存在时间阈值字段中，输入新的天数，Bigtable 会在该天数之后将数据从 SSD 存储空间移至低频访问存储空间。该数字必须大于或等于 30。

gcloud

如需修改不经常访问的存储空间的年龄阈值，请运行带有 --tiered-storage-infrequent-access-older-than 标志的 gcloud beta bigtable instances tables update 命令：

    gcloud beta bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD

替换以下内容：

• TABLE_ID：要更新的表的 ID。
• INSTANCE_ID：实例的 ID。
• PROJECT_ID：包含要更新的表的项目。
• AGE_THRESHOLD：时间阈值，必须至少为 30 天。可接受的单位包括天 (d)、小时 (h)、分钟 (m) 和秒 (s)。示例：从之前的 32d 变为 33d。

控制台

1. 在 Cloud de Confiance 控制台中，打开 Bigtable 实例列表。

   打开实例列表

2. 点击要查看其表的实例。

3. 在左侧窗格中，点击表。

   表页面显示实例中的表列表。

4. 点击要修改的表的 edit 修改。

5. 取消选中启用分层存储复选框。

6. 点击保存。

gcloud

如需停用不频繁访问型存储空间，请使用 gcloud beta bigtable instances tables update 命令并带上 --clear-tiered-storage-config 标志：

    gcloud beta bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --clear-tiered-storage-config

替换以下内容：

• TABLE_ID：要更新的表的 ID
• INSTANCE_ID：实例的 ID
• PROJECT_ID：包含要更新的表的项目