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