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 句で行を絞ってください。