创建和管理表

控制台

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

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

   打开实例列表

2. 点击要在其中创建表的实例。

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

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

4. 点击 add_box 创建表。

5. 在创建表窗格的表 ID 字段中，输入表的永久 ID。

6. 可选：添加列族。

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

7. 可选：在企业 Plus 版中，如需使用微秒级时间戳粒度，请在时间戳粒度部分中选择使用微秒级时间戳。

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

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

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

9. 可选：在配置自动备份部分中，为表配置自动备份。默认情况下，系统会选择启用自动备份，Bigtable 会在实例中的所有集群上创建每日标准备份，并将每个备份保留 7 天。如需了解详情，请参阅使用自动备份。

   • 如果您不希望 Bigtable 每天创建表的备份，请清除启用自动备份。
   • 在 SSD 实例上，如需创建每日热备份而不是标准备份，请在备份类型部分中选择热备份，然后在设置热备份转标准备份的时间字段中输入 1 到 10 之间的整数，以指定每个备份在多少天后自动转换为标准备份。默认值为 3 天，且该值不能超过保留期限。如果启用了分层存储，则无法选择热。如需了解详情，请参阅配置热自动备份。
   • 如需设置自定义保留期限，请在备份配置部分中，在保留期限字段中输入 3 到 90 之间的整数，以指定保留备份的天数。
   • 在企业 Plus 版版中，如需选择 Bigtable 在其中创建每日备份的特定集群，请在备份配置部分中，从选择要备份的集群列表中选择集群，然后点击确定。如需了解详情，请参阅配置自动备份集群位置。

10. 可选：在配置分层存储部分中，为表启用不常访问存储作为分层存储（预览版）的一部分。如果为自动备份选择了热，则无法启用分层存储。

    1. 选中启用分层存储复选框。

    2. 在存在时间阈值字段中，输入一个大于或等于 30 的整数，以指定 Bigtable 将数据从 SSD 存储空间移至不常访问存储空间的天数。

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 每天创建表的备份并将每个备份保留默认保留期限（七天），请在创建表时使用 --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 天。

  在 SSD 实例上，如需将 Bigtable 配置为创建自动转换为标准备份的热自动备份，请使用 --automated-backup-keep-hot-duration 标志，而不是 --enable-automated-backup 标志。请提供 24h（1 天）到 10d（10 天）之间的时长，且不超过保留期限。以数字加上 s、m、h 或 d 单位（秒、分钟、小时或天）表示该值，例如 24h 或 2d。如需了解详情，请参阅配置热自动备份。

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

• 如需启用非频繁访问作为分层存储（预览版）的一部分，请使用 --tiered-storage-infrequent-access-older-than 标志：

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

  将 AGE_THRESHOLD 替换为至少 30 天的值。 可接受的单位包括天 (d)、小时 (h)、分钟 (m) 和秒 (s)，例如 32d 或 32d12h。

• 如需为表配置时间戳粒度，请使用 --timestamp-granularity 标志：

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

  将 TIMESTAMP_GRANULARITY 替换为精确度级别。默认精度为毫秒，值为 MILLIS。如果您希望表接受具有微秒精度的时间戳，请将该值设置为 MICROS。微秒级精度时间戳仅适用于企业 Plus 版中的实例。

cbt

您无法使用 cbt CLI 创建启用了变更数据流的表。

如需创建表，请运行以下命令：

cbt createtable TABLE_ID

将 TABLE_ID 替换为新表的唯一 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

如需根据行键预拆分表，请运行以下命令：

cbt createtable TABLE_ID splits=SPLITS

替换以下内容：

• TABLE_ID：新表的唯一 ID
• SPLITS：用于预拆分的行键前缀的英文逗号分隔列表

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

cbt createtable my-table splits=10,20

控制台

向新表添加列族

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

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

3. 选择列族类型：

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

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

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

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

6. 点击完成。

向现有表添加列族

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

   打开实例列表

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

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

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

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

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

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

   3. 选择列族类型：

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

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

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

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

   6. 点击完成。

6. 点击保存。

gcloud

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

cbt

如需向表中添加列族，请运行以下命令：

cbt createfamily TABLE_ID FAMILY_NAME

替换以下内容：

• TABLE_ID：要在其中添加列族的表的 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

如需从表中删除列族，请运行以下命令：

cbt deletefamily TABLE_ID FAMILY_NAME

替换以下内容：

• TABLE_ID：要从中删除列族的表的 ID
• 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 获取表中现有列族的列表。

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

cbt ls TABLE_ID

将 TABLE_ID 替换为表的唯一 ID。

控制台

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

如需删除表，请运行以下命令：

cbt deletetable TABLE_ID

将 TABLE_ID 替换为表的唯一 ID。

控制台

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

   打开实例列表

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

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

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

4. 点击表 ID 旁边的 more_vert。

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

gcloud

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

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

替换以下内容：

• TABLE_ID：表的唯一标识符
• INSTANCE_ID：实例的 ID

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

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

替换以下内容：

• TABLE_ID：表的唯一标识符
• INSTANCE_ID：实例的 ID

cbt

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

控制台

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

   打开实例列表

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

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

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

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

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

gcloud

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

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：包含要更新的表的项目