Bigtable Studio を使用してデータを管理する
このページでは、 コンソール Google Cloud で Bigtable Studio を使用して Bigtable データを探索して管理する方法について説明します。
Bigtable Studio には [エクスプローラ] ペインがあり、以下の対象と統合されています。
- コードを記述することなくクエリを作成して実行できるインタラクティブなフォームであるクエリビルダー
- SQL コマンドを作成して実行できるクエリエディタ
- SQL クエリ結果テーブル
Bigtable を初めて使用する場合は、
インスタンスを作成し、
cbt CLI
を使用してデータを書き込む方法をご覧ください。
必要なロール
テーブルのクエリに必要な権限を取得するには、テーブルを含むインスタンスに対する次の IAM ロールの付与を管理者に依頼してください。
-
すべて:
Bigtable Reader （
roles/bigtable.reader）
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
データを探す
エクスプローラを使用して、Bigtable リソースに対して次のアクションを実行できます。
| Bigtable リソース | エクスプローラのアクション |
|---|---|
| 表 |
|
| 列ファミリー |
|
| 特定の列ファミリー |
|
| 承認済みビュー |
|
| 論理ビュー |
|
| 継続的マテリアライズド ビュー |
|
[エクスプローラ] にアクセスするには、次の手順に沿って操作します。
コンソール Google Cloud で、[Bigtable インスタンス] ページを開きます。
リストからインスタンスを選択します。
ナビゲーション メニューで [Bigtable Studio] をクリックします。[エクスプローラ] ペインに、インスタンス内のテーブルと承認済みビューのリストが表示されます。
リソースの検索
[エクスプローラ] ペインで、[検索] フィールドを使用して、承認済みビューと列ファミリーを除くすべての Bigtable リソースを検索します。
クエリビルダーでデータにクエリを実行する
クエリビルダーは、コードや SQL ステートメントを記述しなくても、 Google Cloud コンソールから Bigtable Data API に読み取りリクエストを送信できるインタラクティブなフォームです。詳細については、コンソールでクエリを作成する をご覧ください。
クエリエディタで SQL を使用してデータにクエリを実行する
クエリエディタを使用すると、SQL SELECT ステートメントの任意の組み合わせを実行できます。
パイプ構文を使用するステートメントも含まれます。
データにクエリを実行する手順は次のとおりです。
コンソール Google Cloud で、[Bigtable インスタンス] ページを開きます。
リストからインスタンスを選択します。
ナビゲーション メニューで [Bigtable Studio] をクリックします。
クエリを作成します。
- and then choosing [Editor] をクリックして新しいタブを開きます。
- クエリエディタが表示されたら、クエリを入力します。 クエリが有効な SQL の場合、[有効] メッセージが表示されます。
- 省略可: 最新のセルのみではなく、クエリ対象の列のすべてのセルを返すには、テーブル ID に
(with_history => TRUE)を追加します。
省略可: ステートメントを SQL スタイルでフォーマットするには、[フォーマット] をクリックします。
[実行] をクリックします。クエリの結果が [結果] テーブルに表示されます。
クエリが、集計列ファミリーを含むテーブルを対象としている場合、GoogleSQL は結果テーブルの集計セルを自動的にデコードします。
- 合計、最小、最大: 値は、
などの構造化 JSON オブジェクトとして返されます。
{ "sum_column": 8 } - HyperLogLog（HLL）: HLL 値は確率的セットを表します。SQL を使用して HLL データを含む列を選択すると、結果は未加工のバイトまたは base64 として返されます。HLL 列の一意のカーディナリティ（カウント）を推定するには、GoogleSQL HLL++
関数（
HLL_COUNT.EXTRACTやHLL_COUNT.MERGEなど）を使用する必要があります。
- 合計、最小、最大: 値は、
などの構造化 JSON オブジェクトとして返されます。
行のデータのフォーマットされた表示を表示するには、結果テーブルで行をクリックします。[行の詳細] ペインが開きます。各列修飾子とその値が新しい行に表示されます。
(with_history => TRUE)を使用してクエリを実行すると、列の各セルは、セルの値とタイムスタンプを含む構造体として表示されます。省略可: エディタで選択したテキストの一部のみを実行するには、そのテキストをハイライト表示して、[選択項目を実行] をクリックします。ハイライト表示されたクエリの結果が [結果] テーブルに表示されます。
クエリエディタからすべてのテキストを削除するには、[クリア] をクリックします。
Bigtable データにクエリを実行する SQL ステートメントの作成方法について詳しくは、Bigtable 用の GoogleSQL の概要をご覧ください。
クエリ結果をエクスポートする
クエリの結果は、次のいずれかの方法でエクスポートできます。
- CSV または JSON 形式のローカル ファイルをダウンロードする。
- Google スプレッドシートにエクスポートする。
- CSV、TSV、または JSON ファイル形式でクリップボードにコピーする。
クエリエディタまたはクエリビルダーからクエリ結果をエクスポートする手順は次のとおりです。
コンソール Google Cloud で、[Bigtable インスタンス] ページを開きます。
リストからインスタンスを選択します。
ナビゲーション メニューで [Bigtable Studio] をクリックします。
[エクスプローラ] ペインに、インスタンス内のテーブル、ビュー、クエリのリストが表示されます。
[ビルダー] タブまたは [エディタ] タブからクエリを実行します。
結果が [結果] テーブルに表示されます。
[結果] ツールバーで [エクスポート] をクリックします。
メニューからいずれかのエクスポート オプションを選択します。
[Google スプレッドシートにエクスポート] を選択すると、ダイアログが表示されます。[開く] をクリックして、Google スプレッドシートで結果を表示します。
ビューを作成する
Bigtable Studio を使用すると、Bigtable テーブルのビューを作成して保存できます。詳細については、各ビュータイプのドキュメントをご覧ください。
承認済みビュー
クエリビルダーを使用して、承認済み ビューを作成して保存できます。これは、テーブルへのアクセスとは別に アクセス権を付与するテーブルのサブセットです。Bigtable Studio で承認済みビューへのアクセス権を付与したり、承認済みビューを削除したりすることもできます。これを行うには、[エクスプローラ] ペインの [アクション] メニューを使用します。
詳細については、承認済み ビューの作成と管理をご覧ください。
継続的マテリアライズド ビュー
クエリエディタを使用して、継続的マテリアライズド ビューを作成できます。これは、継続的に実行される SQL クエリの事前計算された結果で、増分更新によってソーステーブルと同期されます。継続的マテリアライズド ビューには、ソーステーブルの値に基づく集計データが含まれていることがよくあります。
詳細については、以下のドキュメントをご覧ください。
論理ビュー
クエリエディタを使用して、テーブルのようにクエリできる保存済みクエリである論理ビューを作成できます。論理ビューの操作には、roles/bigtable.reader で付与される権限以上の権限が必要です。詳細については、
論理ビューの作成と管理をご覧ください。
パラメータ化されたビュー
クエリエディタを使用して、パラメータ化されたビューを作成することもできます。これは、 論理ビューの機能を拡張して、アプリケーション提供のコンテキストに基づいて特定のデータ 範囲にフィルタリングするものです。特に、 AI エージェントや大規模言語モデル（LLM）を使用するアプリケーションで役立ちます。詳細については、 パラメータ化されたビューの概要をご覧ください。
保存したクエリ
Bigtable Studio を使用すると、SQL スクリプトを保存済みクエリとして作成、保存、管理できます。詳細については、以下のドキュメントをご覧ください。