BigQuery ウェブ UI

BigQuery のグラフィカルなウェブ UI を使用して、データの読み込みとエクスポート、クエリ、その他のユーザータスクや管理タスクをブラウザから実行できます。

ウェブ UI は、Chrome ウェブブラウザで最適に実行されます。

ウェブ UI の実践的な概要については、BigQuery ウェブ UI クイックスタートをご覧ください。

BigQuery ウェブ UI に移動する

基本

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

  • ページの左側(ナビゲーション バー):

    ナビゲーション バーの上半分には、実行する操作(クエリの作成、クエリ履歴の確認、ジョブ履歴の確認)を示すアイテムのリストがあります。ナビゲーション バーの下半分には、現在のプロジェクトでユーザーが少なくとも読み取りアクセス権を持っているデータセットのリストに加え、BigQuery がすべてのユーザーに公開するパブリック データを格納するパブリック データセット publicdata:samples のリストがあります。各エントリは個別のデータセットであり、構文 projectId:datasetId でプロジェクト名の接尾辞が付けられます。データセットの横にある データセットの展開アイコン アイコンまたはデータセットの名前をクリックすると、展開してデータセット内にあるテーブルが表示されます。

  • ページの上部:

    [COMPOSE QUERY] ボタンをクリックすると、BigQuery SQL 構文でクエリを入力できるクエリボックスが表示されます。クエリを実行するには、クエリボックスの横にある [RUN QUERY] ボタンをクリックします。

  • ページの他の部分:

    ナビゲーション バーで選択した操作に関連する情報が表示されます。

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

: BigQuery ウェブ UI は変更中であり、このドキュメントに記載されているページ要素やテキストの一部は、ツールの現在のバージョンと一致しない場合があります。

テーブルを表示する

ページの左側には、表示できるデータセットが表示されます。データセットの横の データセットの展開アイコン アイコンまたはデータセットの名前をクリックして、そのデータセット内のテーブルを表示します。If you have read access to a dataset, you have read access to all tables in that dataset.

テーブルをクリックすると、画面のメイン セクションにテーブル スキーマの説明が表示されます。 メインビューの右側にある [Query Table] ボタンをクリックして、そのテーブルの基本的なクエリでクエリボックスにデータを追加できます。クエリを手動で変更してフィールドを指定したり、クエリをカスタマイズしたりできます。また、クエリの実行は、現在選択されているテーブルのみに限定されません。

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

すべての作業は、個別のプロジェクトで請求されます。このプロジェクトの名前は、左のナビゲーション バーでデータセットのリストの上に表示されます。 アクセス権を持っているプロジェクトのリストを表示できます。そのためには、画面の左にあるプロジェクト名の横の 下矢印 メニュー表示アイコンを選択し、[Switch to Project] をクリックします。You can click on any of these projects to switch to billing your work to this new project.

共有データセットを表示する

別のユーザーとデータセットを共有することは可能ですが、そのユーザーが、対応する Google Cloud Platform Console プロジェクトに、あなたをユーザーとして追加することはできません。その場合、データセットは自動的にプロジェクトのリストに表示されません。[Display Projects] オプションを使用して、手動で追加する必要があります。

手動でデータセットを追加するには:

  1. プロジェクト名の横にある 下矢印 メニュー表示アイコンを選択します。
  2. [Switch to Project] オプションの上にカーソルを合わせます。
  3. [Display Project] オプションをクリックします。
  4. 表示されるポップアップで、自分と共有されたデータセットのプロジェクト ID を入力します。

そのプロジェクトで共有されているデータセットが、データセット リストの下部に表示されます。

データセットを追加または削除する

画面の左側のリストは、読み取り、書き込み、またはオーナーのアクセス権を持っているデータセットのリストです。

新しいデータセットを作成するには:

  1. プロジェクト名の横にある 下矢印 メニュー表示アイコンをクリックし、[Create new dataset] を選択します。
  2. 左側のナビゲーション バーにリストされていないデータセット名を入力します。名前は、最大 1,024 文字で、A~Z、a~z、0~9、_(アンダースコア文字)で構成できますが、アンダースコアで始めたり、スペースを入れたりすることはできません。
  3. [OK] をクリックしてデータセットを作成します。

データセットを削除するには:

  1. 下矢印 メニュー表示アイコンをクリックして、[Delete dataset] を選択します。

データセットを共有する

  1. データセットの横にある 下矢印 メニュー表示アイコンをクリックします。
  2. [Share dataset] をクリックして、共同編集者の管理ダイアログを開きます。
  3. Google ID で新しいユーザーを追加し、そのユーザーにデータセット上で与えるアクセス権を指定してから、[Add] ボタンをクリックします。ユーザーがデータを読み込んだり、テーブルを作成できるようにするには、データセットに対する「編集可能」アクセス権を付与する必要があります。メール入力ボックスの左にある役割プルダウンを使用して、グループまたはすべてのユーザーと共有することもできます。
  4. 必要に応じて、(データセットのオーナーである場合)既存のユーザーのアクセス権を削除または変更します。
  5. 変更が完了したら、[Save changes] をクリックします。

新しいテーブルを作成する

ファイルを新しいテーブルとして読み込むことができます。既存のテーブルを読み込むと、結果が既存のテーブル コンテンツに追加されます。

ファイルを読み込むには:

  1. テーブルを作成するデータセットの横にある 下矢印 メニュー表示アイコンを選択し、[Create new table] をクリックします。
  2. [Source Data] で、ファイルの場所を指定します。
    • ローカル ファイルを読み込む場合は、[Choose file] を選択し、アップロードする CSV ファイルを表示します。
    • Google Cloud Storage から読み込む場合は、[Google Cloud Storage] を選択し、[Google Storage URI] テキストボックスにファイルパスを入力します。ファイルパスを忘れた場合は、[View files] をクリックして Google Cloud Storage ブラウザを表示することで、ファイルを表示できます。
  3. 次に、ファイル形式を指定します。[File format] セレクタボタンをクリックして、サポートされているファイル形式を選択します。
  4. [Destination Table] で、次の操作を実行します。
    • 新しいテーブルの名前を入力します。 目的のテーブル名はそのデータセット内で固有である必要があり、1~1,024 文字の長さで、a-z、A-Z、0-9、_(アンダースコア文字)のみ含まれている必要があります。テーブル名フィールドの前にあるデータセットのセレクタボタンを使用して、データセットを変更することもできます。
    • [Table type] では、BigQuery ストレージを使用してテーブルを格納する場合は [Native table] を選択します。外部データソースを使用する場合は、[External table] を選択します。
  5. [Schema] で、ファイルのスキーマを入力します。提供されているスキーマ ビルダーを使用するか、[Edit as text] をクリックし、スキーマを文字列として入力します。 文字列形式では、スキーマは column1_name:data_type_1,column2_name:data_type_2,... と記述されます。
    値 "column1_name" と "column2_name" は新しいテーブルの列に割り当てられるラベルで、"data_type_1" と "data_type_2" はアップロードするデータのデータ型です。
  6. [Create Table] をクリックしてデータを読み込みます。

既存のテーブルをコピーする

テーブルをコピーするには:

  1. コピーするテーブルの横にある 下矢印 メニュー表示アイコンをクリックし、[Copy Table] をクリックします。 You must have READ permission to the source dataset of the table being copied, and WRITE permission to the destination dataset.
  2. 新しいテーブルを格納するデータセットを選択します。
  3. 新しいテーブルの名前を入力します。この名前は、テーブルが属するデータセット内で一意である必要があります。テーブル名の長さは最大 1,024 文字で、a~z、A~Z、0~9、_(アンダースコア文字)のみ含めることができます。
  4. [OK] をクリックしてコピージョブを開始します。

テーブルにデータを追加する

データを読み込みオペレーションの宛先として指定するか、クエリの実行時にクエリ オプションに「テーブルを追加」書き込み処理を指定することで、テーブルにデータを追加できます。

テーブルを削除する

テーブルを削除するには、書き込みアクセス権を持っているテーブルの横にある 下矢印 メニュー表示アイコンをクリックし、[Delete Table] をクリックします。

テーブルのスキーマを確認する

テーブルのスキーマを表示するには、画面左側の開いているデータセットからテーブルを選択します。

テーブルのデータを確認する

ナビゲーション パネルでテーブルをクリックし、メインビューの右側にある [Details] タブをクリックして、テーブル内のデータをプレビューできます。

クエリを実行する

クエリを実行するには、ナビゲーション·バーの上部にある [Compose Query] をクリックし、ページの上部にあるサイズ変更可能なボックスにクエリ文字列を入力します。クエリテキストの作成を完了したら、[Run Query] をクリックしてクエリを実行します。[Run Query] をもう一度クリックするとクエリを再実行できます。

複数のデータセットまたはプロジェクトにアクセスするクエリを作成できます。そのためには、projectId:datasetId.tableId 構文を使用してテーブル名を修飾します。 プロジェクト ID を指定しない場合、現在のプロジェクトを指定したと想定されます。

データのダウンロード、保存、エクスポート

クエリの結果セットが 16,000 行未満の場合は、CSV または改行区切りの JSON ファイルとしてダウンロードできます。それ以上の行数がある場合は、テーブルとして保存することのみができます。

BigQuery ウェブ UI のダウンロードおよび保存ボタンのスクリーンショット

クエリ結果をダウンロードする

CSV ファイルとしてクエリ結果をダウンロードするには:

  • クエリ結果の上にある [Download as CSV] をクリックします。

JSON ファイルとしてクエリ結果をダウンロードするには:

  • クエリ結果の上にある [Download as JSON] ボタンをクリックします。

クエリ結果を保存する

クエリ結果をテーブルとして保存するには:

  • クエリ結果の上にある [Save as Table] ボタンをクリックします。

クエリ結果を Google スプレッドシートに保存するには:

  • クエリ結果の上にある [Save to Google Sheets] ボタンをクリックします。

テーブルをエクスポートする

テーブル全体を Google Cloud Storage にエクスポートすることもできます。

テーブル全体をエクスポートするには:

  1. エクスポートするテーブルを選択し、テーブルの横にある 下矢印 メニュー表示アイコンをクリックします。
  2. [Export table] をクリックしてテーブルのエクスポート ダイアログを開きます。
  3. 目的の出力形式とエクスポートされるファイルの完全修飾 Google Cloud Storage URI を入力します。対象のバケット上でアクセス権を持っている必要があります。

クエリ履歴を表示する

ナビゲーション バーの [Query History] をクリックすると、最新実行したクエリの完全な履歴を表示できます。履歴ページでクエリを再実行するには、クリックしてクエリを展開し、[Run Query] をクリックします。

表示の制限

UI で表示できるデータセットは 1,000 のみです。ナビゲーション パネルには、データセットごとに 1,000 のテーブルのみを表示できます。 それ以上のテーブルを表示するには、ナビゲーション パネルでデータセット名をクリックして [Dataset Details] ページを開きます。[Dataset Details] ページには最大 30,000 のテーブルが表示されます。

まれなケースとして、大量のテーブルを含むデータセットがプロジェクトに大量にあると、パフォーマンスが影響を受けることがあります。そのシナリオでパフォーマンスを改善するには、"?minimal" パラメータを使用してプロジェクトごとにロードするテーブル数を 30,000 に制限します。次に例を示します。

https://bigquery.cloud.google.com/queries/<your_project_name>?minimal.

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

次のキーボード ショートカットがサポートされています。

キーの組み合わせ(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 クエリを書式設定します。

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

BigQuery のドキュメント