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 の場合は、[有効] メッセージが表示されます。
- 省略可: 最新のセルだけでなく、クエリされた列のすべてのセルを返すには、テーブル 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 テーブルの論理ビューを作成して保存できます。論理ビューのオペレーションには、roles/bigtable.reader で付与された権限を超える権限が必要です。詳細については、各ビュータイプのドキュメントをご覧ください。
承認済みビュー
クエリビルダーを使用して、承認済みビューを作成して保存できます。これは、テーブルへのアクセス権とは別にアクセス権を付与するテーブルのサブセットです。Bigtable Studio で、エクスプローラの [アクション] メニューを使用して、承認済みビューへのアクセス権を付与したり、承認済みビューを削除したりすることもできます。
詳細については、承認済みビューの作成と管理をご覧ください。
マテリアライズド ビュー
クエリエディタを使用して、マテリアライズド ビューを作成できます。これは、増分更新でソーステーブルと同期する継続的に実行される SQL クエリの事前計算結果です。マテリアライズド ビューには、ソーステーブルの値に基づいて集計されたデータが含まれていることがよくあります。
詳細については、以下のドキュメントをご覧ください。
論理ビュー
クエリ エディタを使用して、テーブルのようにクエリできる論理ビュー（保存済みクエリ）を作成することもできます。詳細については、ビューの作成と管理をご覧ください。