BigQuery ウェブ UI の使用

BigQuery で公開されるグラフィカル ウェブ UI を使用すると、BigQuery リソースの作成と管理、および SQL クエリの実行が可能です。このページでは、BigQuery ウェブ UI の使用方法の概要について説明します。

ウェブ UI の使用方法入門については、BigQuery ウェブ UI クイックスタートをご覧ください。

始める前に

BigQuery ブラウザツールを使用するには、Cloud Console で BigQuery が有効になったプロジェクトにアクセス可能なアカウントが必要です。新しく作成したプロジェクトは、デフォルトで BigQuery が有効になります。Google Cloud Platform の無料枠の使用限度を超える可能性がある場合は、プロジェクトの課金を有効にする必要もあります。

  1. Google アカウントにログインします。

    Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

  2. GCP プロジェクトを選択または作成します。

    [リソースの管理] ページに移動

  3. プロジェクトに対して課金が有効になっていることを確認します。

    課金を有効にする方法について

  4. 新しいプロジェクトでは、BigQuery が自動的に有効になります。既存のプロジェクトで BigQuery を有効にする手順は以下のとおりです。 BigQuery API を有効にする。

    Enable the API

ウェブ UI を開く

ウェブ UI を開くには、ブラウザに次の URL を入力します。project_id は、ウェブ UI で開くプロジェクトの ID に置き換えてください。

https://bigquery.cloud.google.com/project_id

下のボタンをクリックすると、最近アクセスしたプロジェクトを使用してウェブ UI が開かれます。

ウェブ UI に移動

ウェブ UI の概要

ウェブ UI には 3 つのメイン セクションがあります。

  1. ページの左側(ナビゲーション ペイン):
    ナビゲーション ペインの上半分には、行う操作(クエリの作成、クエリ履歴の確認、ジョブ履歴の確認)を示すアイテムのリストがあります。
    ナビゲーション ペインの下半分には、アクセス権を持つ現在のプロジェクト内のデータセット、および BigQuery 一般公開データセットのリストがあります。フィルタ ボックスを使うと、データセット ID またはラベルでフィルタリングできます。
  2. 詳細ペイン:
    ナビゲーション ペインで選択した操作に関連する情報が表示されます。たとえば、ナビゲーション ペインでデータセットをクリックすると、そのデータセットに関する情報が詳細ペインに表示されます。
  3. クエリ ウィンドウ:
    [Compose Query] をクリックすると、詳細ペインの上に [New Query] ウィンドウが追加されます。このウィンドウが不要な場合は閉じることができます。

BigQuery ウェブ UI のスクリーンショット

リソースの表示

ナビゲーション ペインには、現在のプロジェクト内の標示可能なデータセットのリストが表示されます。データセットの横にある データセットの展開アイコン アイコンまたはデータセットの名前をクリックすると、データセットが展開され、その中にあるテーブルが表示されます。

テーブルをクリックすると、そのテーブルに関する情報が詳細ペインに表示されます。ペインの右側にある [Query Table] ボタンをクリックすると、そのテーブルに対する基本クエリがクエリボックスに入力されます。クエリは手動で変更してフィールドを指定したり、クエリをカスタマイズしたりできます。また、クエリの実行は現在選択されているテーブルのみに限定されません。テーブルに対するクエリの実行の詳細については、インタラクティブ クエリの実行をご覧ください。

プロジェクトの追加と削除

BigQuery の作業はすべてプロジェクト内で行われます。このプロジェクトの名前は、ナビゲーション ペインにあるデータセットのリストの上で確認できます。プロジェクトで行うすべての作業は、プロジェクトに関連付けられた請求先アカウントに課金されます。BigQuery の課金の詳細については、料金のページをご覧ください。

ウェブ UI では次のことを行えます。

  • 他のプロジェクトを追加(または固定)する
  • 固定したプロジェクトを削除する
  • 別のプロジェクトに切り替える

プロジェクトの追加

ウェブ UI でプロジェクトのプルダウン メニューを使用すると、プロジェクトを追加または「固定」できます。プロジェクトをナビゲーション ペインに固定すると、別のプロジェクト内のリソースを表示してクエリを実行できるようになります。固定したプロジェクトのリソースにクエリを実行した場合、そのクエリ料金は自分のプロジェクトに関連付けられた請求先アカウントに課金されます。固定されたプロジェクトには課金されません。

UI にプロジェクトを追加するには:

  1. ナビゲーション ペインでプロジェクト名の横にある下向き矢印アイコン 下矢印アイコン をクリックします。

  2. プルダウン メニューで、[Switch to project] > [Display project] をクリックします。

  3. [Display Project] ダイアログで次のようにします。

    • プロジェクト ID を入力します。
    • [Display project in navigation panel] が選択されたままにします。
    • [OK] をクリックして、ナビゲーション パネルにプロジェクトを追加します。

    [Display Project] ダイアログ

UI からのプロジェクトの削除

以前に追加(または「固定」)したプロジェクトを削除するには:

  1. ナビゲーション ペインでプロジェクト名の横にある下向き矢印アイコン 下矢印アイコン をクリックします。

  2. プルダウン メニューで、[Remove project from panel] をクリックします。

プロジェクトの切り替え

別のプロジェクトに切り替える(そのプロジェクトを UI に固定しない)場合は、コンテキスト メニューを使用します。

プロジェクトを切り替えるには:

  1. ナビゲーション ペインでプロジェクト名の横にある下向き矢印アイコン 下矢印アイコン をクリックします。

  2. プルダウン メニューで [Switch to project] をクリックし、リストからプロジェクトを選択します。UI 内のこれまでのプロジェクトが、選択したプロジェクトに置き換えられます。

共有データセットの追加

別のユーザーに該当するプロジェクトへのアクセス権を付与することなく、そのユーザーとデータセットを共有できます。共有が行われると、その共有データセットが含まれたプロジェクト名のメールを受信します。そのプロジェクトとデータセットが UI へ自動的に表示されるわけではありません。

メールの browser tool リンクをクリックすると、そのプロジェクトが表示された状態でウェブ UI が開きます。共有データセットが含まれたプロジェクトを固定する場合は、プロジェクトの追加の手順に従ってください。

ジョブ履歴とクエリ履歴の表示

ウェブ UI を使用してジョブの実行クエリの実行を行うと、その履歴がナビゲーション ペインに保存されます。クエリも一種のジョブですが、使いやすさを考えてクエリ履歴は別途保存されます。

UI 内のジョブとクエリの履歴には、最近 6 か月以内のすべての読み込み、エクスポート、コピーと、送信したクエリジョブが含まれます(最大 1,000 エントリ)。1,000 ジョブという上限は、すべての種類のジョブの累計に対するものです。

ジョブ履歴の表示

ジョブ履歴を表示するには、次のいずれかを行います。

  • ナビゲーション ペインの [Job History] リンクをクリックします。

  • ブラウザに次の URL を入力します。

    https://bigquery.cloud.google.com/jobs/project_id

ウェブ UI を使用して読み込みジョブを反復することはできますが、エクスポートまたはコピージョブは反復できません。

クエリ履歴の表示

クエリ履歴を表示するには、次のいずれかを行います。

  • ナビゲーション ペインの [Query History] リンクをクリックします。

  • ブラウザに次の URL を入力します。

    https://bigquery.cloud.google.com/queries/project_id

ウェブ UI を使用して、クエリジョブを反復できます。

ジョブ履歴とクエリ履歴の検索

クエリ履歴またはジョブ履歴をフィルタリング(または検索)して、条件に適合した特定のジョブだけを表示できます。返される結果は、UI で取得されたジョブのプールに制限されます。デフォルトでは、最新の 1,000 個のジョブを UI で検索できます。

履歴内にある全ジョブのリストを表示するには、jobs.list API メソッドまたは CLI コマンドの bq ls を使用します。

クエリ履歴またはジョブ履歴をフィルタリングするには:

  1. ナビゲーション ペインで、[Job History] または [Query History] をクリックします。
  2. [filter jobs] プルダウン メニューをクリックして、フィルタ式のボックスを表示します。
  3. フィルタ式のボックスで次のようにします。

    • [Any] をクリックしてフィルタ条件を選択します。
    • [operator] プルダウン メニューをクリックして演算子を選択します。選択した条件に応じて演算子リストは変化します。たとえば、条件として [text] を選択すると演算子リストには [substring] と [regex] が含まれます。
    • ボックスに値を入力します。

      フィルタ式ビルダー

  4. [AND] をクリックすると、フィルタに条件をさらに追加できます。

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

次のいずれかのジョブ プロパティを使用すると、クエリジョブをフィルタリングできます。

  • [Any] - すべてのプロパティ。
  • [Job ID (jobid)] - ジョブの一意の不透明 ID。
  • [User (user)] - ジョブを送信したユーザー。
  • [Start Time (start)] - エポックからのミリ秒単位で表わしたジョブの開始時間。このプロパティが存在するのは、ジョブが PENDING 状態から RUNNING または DONE 状態へ移行した場合です。
  • [End Time (end)] - エポックからのミリ秒単位で表わしたジョブの終了時間。ジョブが DONE 状態であればこのプロパティが存在します。
  • [Destination table (dest)] - ジョブ オペレーション(読み込み、コピー、クエリ)の宛先テーブルの名前。
  • [Query text] - 送信された SQL クエリのテキスト。
  • [Bytes processed] - SQL クエリで処理された合計バイト数。
  • [UDF code] - ユーザー定義関数(UDF)のコードが含まれたインライン リソース。

次のいずれかのジョブ プロパティを使用すると、読み込み、コピー、抽出の各ジョブをフィルタリングできます。

  • [Any] - すべてのプロパティ。
  • [Job ID (jobid)] - ジョブの一意の不透明 ID。
  • [User (user)] - ジョブを送信したユーザー。
  • [Start Time (start)] - エポックからのミリ秒単位で表わしたジョブの開始時間。このプロパティが存在するのは、ジョブが PENDING 状態から RUNNING または DONE 状態へ移行した場合です。
  • [End Time (end)] - エポックからのミリ秒単位で表わしたジョブの終了時間。ジョブが DONE 状態であればこのプロパティが存在します。
  • [Destination table (dest)] - ジョブ オペレーション(読み込み、コピー、クエリ)の宛先テーブルの名前。
  • [Title (title)] - 履歴に表示されるタイトル。たとえば、読み込みジョブのタイトルは「uploaded file to myproject:mydataset.mytable」となります。
  • [Type (type)] - ジョブの種類: 読み込み、クエリ、コピー、抽出(エクスポート)。
  • [Copy source (copysrc)] - コピージョブのコピー元テーブル。
  • [Destination URI (desturi)] - 抽出(エクスポート)ジョブの Cloud Storage の抽出先 URI。
  • [Source table (srctable)] - 抽出ジョブの抽出元テーブル。
  • [Source URI (srcuri)] - 読み込みジョブの Cloud Storage の読み込み元 URI。

クエリ履歴の並べ替え

[Queries] ペインの [Sort By] オプションを使用して、UI 内のクエリ履歴を並べ替えることもできます。[Queries] ペインを開くには、ナビゲーション ペインで [Query History] をクリックします。

クエリ履歴 [Sort By] ボタン

並べ替えオプションは次のとおりです。

  • Date - クエリを実行日で並べ替えます。
  • Duration - クエリを合計実行時間で並べ替えます。
  • Duration / byte - 入力バイトで正規化して、期間でクエリを並べ替えます。これにより、さまざまな入力サイズでクエリの実行時間を比較できます。たとえば、時間の経過に伴って増加する一連のテーブルがあり、入力サイズの変更によってのみ発生する差を無視しながら、クエリの効率を比較したい場合があります。これは、入力サイズと実行時間の関係が線形であることを前提としています。
  • Input bytes - クエリを読み取られたバイト数で並べ替えます。
  • Slot-ms - クエリによって使用されるすべてのスロットでアクティブなミリ秒の合計でクエリを並べ替えます。slot-ms による並べ替えは、観測された期間に影響を与える可能性のあるシステムの遅延や他の不確実さの原因による影響が少ないため、より安定した処理作業の測定結果になります。
  • Slot-ms / byte - Duration / byte と同様に、Slot-ms / byte は slot-ms の正規化された形式です。

    クエリ履歴並べ替えオプション

ウェブ UI の表示制限

ウェブ UI の表示には次の制限があります。

  • ナビゲーション ペインに表示できるプロジェクト数は最大 10,000 です。
  • ナビゲーション ペインに表示できるプロジェクトごとのデータセット数は最大 1,000 です。
  • データセットごとにナビゲーション ペインに表示できるテーブル数は最大 30,000 です。表示可能なすべてのデータセットの累計テーブル数は 75,000 です(固定されたプロジェクトのデータセットを含む)。

ウェブ UI の表示パフォーマンスの制御

まれなケースとして、大量のテーブルを含むデータセットがプロジェクトに大量にあると、パフォーマンスが影響を受けることがあります。プロジェクトに大量のリソースが含まれる場合に UI のパフォーマンスを改善するには、?minimal パラメータを使用して、表示するリソース数をプロジェクトごとに 10,000 テーブルに制限します。たとえば、ブラウザに次の URL を入力して、表示されるリソース数を制限します。

https://bigquery.cloud.google.com/queries/project_id?minimal

キーボード ショートカット

ウェブ UI では次のキーボード ショートカットがサポートされています。

キーの組み合わせ(Windows / Linux) キーの組み合わせ(Mac OS) 操作
Ctrl+Space Ctrl+Space オープンされているクエリがない場合: 新しいクエリを作成
クエリエディタが開いている場合: 現在の単語をオートコンプリート
Ctrl+Enter Cmd+Enter 現在のクエリを実行
Tab Tab 現在の単語をオートコンプリート
Ctrl Cmd テーブル名をハイライト表示
Ctrl キーを押しながらテーブル名をクリック Cmd キーを押しながらテーブル名をクリック テーブル スキーマを開く
Ctrl+E Cmd+E 選択項目からクエリを実行
Ctrl+/ Cmd+/ 現在の行または選択した行にコメントを付ける
Ctrl+Shift+F Cmd+Shift+F クエリを書式設定

ウェブ UI の例は、BigQuery ドキュメントの入門ガイドに多く記載されています。以下は、クエリの実行や、BigQuery リソースの作成、取得、一覧表示、削除、変更などの一般的なウェブ UI タスクへのリンクです。

データのクエリ

ウェブ UI を使用してクエリを作成および実行する方法については、次をご覧ください。

リソースの作成

ウェブ UI を使用してリソースを作成する方法については、次をご覧ください。

リソースに関する情報の取得

ウェブ UI を使用してリソースに関する情報を取得する方法については、次をご覧ください。

リソースの一覧表示

ウェブ UI を使用してリソースを一覧表示する方法については、次をご覧ください。

リソースの更新

ウェブ UI を使用してリソースを更新する方法については、次をご覧ください。

データの読み込み

ウェブ UI を使用してデータを読み込む方法については、次をご覧ください。

外部データソースの使用

ウェブ UI を使用して外部データソースのデータをクエリする方法については、次をご覧ください。

データのエクスポート

ウェブ UI を使用してデータをエクスポートする方法については、次をご覧ください。

BigQuery Data Transfer Service の使用

BigQuery Data Transfer Service でウェブ UI を使用する方法については、次をご覧ください。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。