Bigtable Studio を使用してデータを管理する
このページでは、 Google Cloud コンソールで Bigtable Studio を使用して Bigtable データを探索して管理する方法について説明します。
Bigtable Studio には [エクスプローラ] ペインがあり、以下の対象と統合されています。
- コードを記述することなくクエリを作成して実行できるインタラクティブなフォームであるクエリビルダー
- クエリエディタ。SQL コマンドを作成して実行できます。
- SQL クエリ結果テーブル
Bigtable を初めて使用する場合は、cbt CLI を使用してインスタンスを作成し、データを書き込む
方法をご覧ください。
必要なロール
テーブルのクエリに必要な権限を取得するには、テーブルを含むインスタンスに対する次の IAM ロールの付与を管理者に依頼してください。
-
すべて: Bigtable 読み取り （
roles/bigtable.reader）
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
データを探す
エクスプローラを使用して、Bigtable リソースに対して次のアクションを実行できます。
| Bigtable リソース | エクスプローラのアクション |
|---|---|
| 表 |
|
| 列ファミリー |
|
| 特定の列ファミリー |
|
| 承認済みビュー |
|
| 表示 |
|
| マテリアライズド ビュー |
|
[エクスプローラ] にアクセスする手順は、次のとおりです。
Google Cloud コンソールで、[Bigtable インスタンス] ページを開きます。
リストからインスタンスを選択します。
ナビゲーション メニューで [Bigtable Studio] をクリックします。[エクスプローラ] ペインに、インスタンス内のテーブルと承認済みビューのリストが表示されます。
クエリビルダーでデータをクエリする
クエリビルダーは、コードや SQL ステートメントを記述することなく、 Google Cloud コンソールから Bigtable Data API に読み取りリクエストを送信できるインタラクティブなフォームです。詳細については、コンソールでクエリを作成するをご覧ください。
クエリエディタで SQL を使用してデータにクエリを実行する
クエリエディタを使用すると、SQL SELECT ステートメントの任意の組み合わせを実行できます。ステートメントはセミコロンで区切る必要があります。
ステートメントは、クエリエディタに入力した順に実行されます。
データをクエリする手順は次のとおりです。
Google Cloud コンソールで、[Bigtable インスタンス] ページを開きます。
リストからインスタンスを選択します。
ナビゲーション メニューで [Bigtable Studio] をクリックします。
クエリを作成します。
- をクリックして [エディタ] を選択し、新しいタブを開きます。
- クエリエディタが表示されたら、クエリを入力します。 クエリが有効な SQL の場合は、[Valid]（有効）というメッセージが表示されます。
- 省略可: 最新のセルだけでなく、クエリされた列のすべてのセルを返すには、テーブル ID に
(with_history => TRUE)を追加します。
省略可: ステートメントを SQL スタイルでフォーマットするには、[フォーマット] をクリックします。
[実行] をクリックします。クエリの結果が [結果] テーブルに表示されます。
行のデータの形式設定された表示を確認するには、結果テーブルで行をクリックします。[行の詳細] ペインが開きます。各列修飾子とその値が新しい行に表示されます。
(with_history => TRUE)を使用してクエリを実行すると、列の各セルは、セルの値とタイムスタンプを含む構造体として表示されます。省略可: エディタで選択したテキストの一部のみを実行するには、その部分をハイライト表示して、[選択したものを実行] をクリックします。ハイライト表示されたクエリの結果が [結果] テーブルに表示されます。
クエリエディタからすべてのテキストを削除するには、[クリア] をクリックします。
Bigtable データをクエリする SQL ステートメントの作成に関する詳細（例を含む）については、Bigtable 用の GoogleSQL の概要をご覧ください。
クエリ結果をエクスポートする
クエリの結果は、次のいずれかの方法でエクスポートできます。
- ローカルファイルを CSV 形式または JSON 形式でダウンロードします。
- Google スプレッドシートにエクスポートします。
- CSV、TSV、JSON ファイル形式でクリップボードにコピーします。
クエリエディタまたはクエリビルダーからクエリ結果をエクスポートする手順は次のとおりです。
Google Cloud コンソールで、[Bigtable インスタンス] ページを開きます。
リストからインスタンスを選択します。
ナビゲーション メニューで [Bigtable Studio] をクリックします。
[エクスプローラ] ペインに、インスタンス内のテーブル、ビュー、クエリのリストが表示されます。
[ビルダー] タブまたは [エディタ] タブからクエリを実行します。
結果が [結果] テーブルに表示されます。
[結果] ツールバーで [エクスポート] をクリックします。
メニューから、いずれかのエクスポート オプションを選択します。
[Export to Google Sheets] を選択すると、ダイアログが表示されます。[開く] をクリックして、Google スプレッドシートで結果を表示します。
ビューを作成する
Bigtable Studio を使用すると、Bigtable テーブルのビューを作成して保存できます。詳細については、各ビュータイプのドキュメントをご覧ください。
承認済みビュー
クエリビルダーを使用して、承認済みビューを作成して保存できます。これは、テーブルへのアクセス権とは別にアクセス権を付与するテーブルのサブセットです。Bigtable Studio で、エクスプローラの [アクション] メニューを使用して、承認済みビューへのアクセス権を付与したり、承認済みビューを削除したりすることもできます。
詳細については、承認済みビューの作成と管理をご覧ください。
継続的マテリアライズド ビュー
クエリ エディタを使用して、継続的マテリアライズド ビューを作成できます。これは、増分更新でソーステーブルと同期する継続的に実行される SQL クエリの事前計算結果です。継続的マテリアライズド ビューには、ソーステーブルの値に基づいて集計されたデータが含まれていることがよくあります。
詳細については、以下のドキュメントをご覧ください。
論理ビュー
クエリ エディタを使用して、テーブルのようにクエリできる論理ビュー（保存済みクエリ）を作成することもできます。論理ビューのオペレーションには、roles/bigtable.reader で付与された権限を超える権限が必要です。詳細については、論理ビューの作成と管理をご覧ください。
クエリを保存する
Query Editor またはクエリビルダーからクエリを保存する手順は次のとおりです。
Google Cloud コンソールで、[Bigtable インスタンス] ページを開きます。
リストからインスタンスを選択します。
ナビゲーション メニューで [Bigtable Studio] をクリックします。
[エクスプローラ] ペインに、インスタンス内のテーブル、ビュー、クエリのリストが表示されます。
[ビルダー] タブまたは [エディタ] タブからクエリを実行します。
結果が [結果] テーブルに表示されます。
[結果] ツールバーで、[保存] をクリックします。
[クエリを保存] ダイアログで、保存済みクエリの名前を入力します。
[保存] をクリックします。
クエリを別の名前で保存するには、[名前を付けて保存] 展開矢印をクリックし、[クエリを名前を付けて保存] を選択して、ダイアログに新しい名前を入力します。
クエリを論理ビューまたは継続的マテリアライズド ビューとして保存するには、それぞれのビュータイプのドキュメントをご覧ください。
保存済みクエリの表示と管理
プロジェクトに保存されているクエリのリストを表示する手順は次のとおりです。
Google Cloud コンソールで、[Bigtable インスタンス] ページを開きます。
リストからインスタンスを選択します。
ナビゲーション メニューで [Bigtable Studio] をクリックします。
[エクスプローラ] ペインで、[クエリ] セクションに移動します。
保存済みクエリの横にある [アクションを表示] をクリックします。[クエリを管理する] をクリックします。
[保存済みクエリ] ページが開きます。このページには、このプロジェクト内のすべての保存済みクエリ（他の Google Cloud プロダクトの保存済みクエリを含む）が一覧表示されます。
クエリの検索、フィルタ、表示、削除は、[保存済みクエリ] ページで行えます。[保存済みクエリ] ページで既存のクエリを編集することはできません。