テーブルの作成と管理

コンソール

インスタンスに新しいテーブルを作成するには:

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. テーブルを表示するインスタンスをクリックします。

3. 左ペインで [テーブル] をクリックします。

   [テーブル] ページに、インスタンス内のテーブルのリストが表示されます。

4. テーブルのテーブル ID を入力します。

5. 列ファミリーの追加（省略可）

   列は後から追加することもできます。テーブルにデータを書き込むには、テーブルに少なくとも 1 つの列ファミリーが必要です。テーブルへのデータの書き込みや変更ストリームの読み取りを行うには、テーブルに少なくとも 1 つの列ファミリーが必要です。

6. 省略可: テーブルの変更ストリームを有効にします。変更ストリームを有効にする前に、ストレージ コストの増加やアプリ プロファイルの使用要件など、その影響を把握しておく必要があります。詳細については、変更ストリームの概要をご覧ください。

   1. [変更ストリームを有効にする] を選択します。

   2. [有効期限] フィールドに、1～7 の数値を入力して、変更ストリーム データの保持日数を指定します。

   3. [作成] をクリックします。

7. 省略可: Bigtable でテーブルの日次バックアップを作成しない場合は、[自動バックアップを有効にする] の横にあるチェックボックスをオフにします。詳細については、自動バックアップを使用する（プレビュー）をご覧ください。

8. [テーブルの作成] をクリックします。

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 でテーブルの日次バックアップを作成できるようにするには、自動バックアップを有効にします（プレビュー）。

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

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 にする必要があります。

コンソール

Google Cloud コンソールを使用してテーブルを作成する場合、行を事前に分割することはできません。

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] は、事前分割に使用する行キー接頭辞のカンマ区切りのリストに置き換えます。

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

たとえば、10 または 20 で始まる行キーでテーブル my-table を事前分割する場合には、次のように指定します。

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

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. テーブルを表示するインスタンスをクリックします。

3. 左ペインで [テーブル] をクリックします。

   [テーブル] ページに、インスタンス内のテーブルのリストが表示されます。

4. 変更するテーブルの [edit 編集] をクリックします。

5. 追加する列ファミリーごとに、次の手順を行います。

   1. [Add column family] をクリックします。
   2. 列ファミリーの一意の識別子を指定します。
   3. 列ファミリーのガベージ コレクションを設定します。
   4. [完了] をクリックします。
   5. [保存] をクリックします。

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. Google Cloud コンソールで 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. Google Cloud コンソールで 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 {
  List<String> tableIds = adminClient.listTables();
  for (String tableId : tableIds) {
    System.out.println(tableId);
  }
} 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 instance.getTables();
tables.forEach(table => {
  console.log(table.id);
});

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. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. テーブルを表示するインスタンスをクリックします。

3. 左ペインで [テーブル] をクリックします。

   [テーブル] ページに、インスタンス内のテーブルのリストが表示されます。Google Cloud コンソールには、テーブルが保存されているクラスタ数、テーブルのステータス、ストレージの使用率、テーブルの現在のバックアップの ID がテーブルごとに表示されます。

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. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. テーブルを表示するインスタンスをクリックします。

3. 左ペインで [テーブル] をクリックします。

   [テーブル] ページに、インスタンス内のテーブルのリストが表示されます。

4. 削除するテーブルの [more_vert] をクリックします。

5. [削除] をクリックします。

6. この操作でインスタンス内のすべてのクラスタからテーブルが削除され、テーブルの削除を取り消す期限があと 7 日間であることを確認するには、テキスト ボックスにテーブル ID を入力します。

7. [削除] をクリックします。

gcloud

1. テーブルを削除するには、gcloud bigtable instances tables delete コマンドを実行します。

   gcloud bigtable instances tables delete --instance=INSTANCE_ID
   

   以下のように置き換えます。

   • INSTANCE_ID: インスタンスの ID

2. ターミナルで「y」と入力して、テーブルの削除を確定します。

cbt

テーブルを削除するには、[TABLE_NAME] をテーブル名に置き換えて次のコマンドを実行します。

cbt deletetable [TABLE_NAME]

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. テーブルを表示するインスタンスをクリックします。

3. 左ペインで [テーブル] をクリックします。

   [テーブル] ページに、インスタンス内のテーブルのリストが表示されます。

4. テーブル ID の横にある more_vert をクリックします。

5. 削除からの保護を有効にするには、[削除を防止する] をクリックします。削除からの保護を無効にするには、[削除を有効にする] をクリックします。有効なオプションのみが表示されます。

gcloud

テーブルに対する削除からの保護を有効にするには、gcloud bigtable instances table update コマンドを実行します。

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

テーブルに対する削除からの保護を無効にするには、次のコマンドを実行します。

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 を使用して削除からの保護を有効または無効にすることはできません。