本文へスキップ

Google BigQuery クライアント

GoogleSQL を書き、実行前にクエリ費用を見積もり、ジョブの課金対象バイト数に上限を設定できます。

概要

クエリ言語
SQL
ドライバー
初回使用時にダウンロード
接続方法
サービスの API

Google Cloud にログイン

Auth Method を選び、名前や番号ではなく Project ID を入力します。Application Default Credentials は gcloud のログインファイルを使い、Service Account Key は JSON ファイルや貼り付けたキーを受け付けます。

Google Account (OAuth) は、Google Cloud Console で作成したデスクトップ OAuth クライアントでブラウザーからログインします。更新トークンはクライアントごとに一つキーチェーンに保持するため、次回以降の接続ではブラウザーを開きません。一つの OAuth クライアントでログインできるのは一つの Google アカウントなので、二つ目のアカウントには別のクライアントが必要です。すべて BigQuery の REST API を使うため、ホスト、ポート、SSH トンネルはありません。Location は各ジョブの処理場所を設定します。

クエリと費用の制御

Explain メニューの Dry Run (Cost) は、クエリを実行せずに処理バイト数、課金バイト数、オンデマンド費用を見積もります。実行後は同じ数値をキャッシュ状態と一緒に表示します。Max Bytes Billed は、設定した上限を超えるジョブを拒否します。

補完、引用符、整形は GoogleSQL に従い、STRUCT と ARRAY の列は JSON で表示します。データセットがデータベースの役割を担い、⌘K で切り替えます。ジョブはクエリタイムアウトまでポーリングし、その後キャンセルします。グリッドからの UPDATE と DELETE は、宣言した主キー、なければ ARRAY、JSON、GEOGRAPHY 以外の全列で行を特定するため、同一の行は一緒に変わります。一行を正確に編集するには PRIMARY KEY (…) NOT ENFORCED を宣言してください。パーティションテーブルでは、エディターでパーティションフィルター付きの UPDATE と DELETE を書いてください。

データセットと DDL

CREATE SCHEMA、ALTER TABLE … ADD COLUMN、CREATE OR REPLACE VIEW などの DDL はエディターで実行します。New Database… はデータセットを作成し、テーブルはサイドバーから名前を変更できます。DDL タブは各定義を INFORMATION_SCHEMA.TABLES から読み取り、クラスタリングとパーティションは Indexes に表示します。

このページでは Google BigQuery 固有の内容を扱います。Safe Mode、AI アシスタント、MCP サーバーなど TablePro のその他の機能は機能ページで紹介しています。

その他

  • データの移動

    テーブルやクエリ結果を Mac に CSV、JSON、SQL、XLSX、Markdown、HTML と XML でエクスポートできます。Server-Side Export は EXPORT DATA で CSV、Parquet、改行区切り JSON を gs:// プレフィックスに出力するため、ファイルは Mac を経由しません。

  • 制限

    • Structure タブは読み取り専用です。エディターで DDL を実行してください。
    • トランザクションは非対応です。
  • BigQuery 接続に必要な IAM ロールは?

    クエリの実行には roles/bigquery.user、データの読み取りには roles/bigquery.dataViewer、変更には roles/bigquery.dataEditor が必要です。

  • テーブルの深いページへ移動せず、絞り込むのはなぜですか?

    テーブルの深いページは、そのたびに先頭から再スキャンします。代わりにフィルターや WHERE 句で行を絞ってください。

TablePro を入手

このページの機能はすべて無料です。