/setup-bigquery

description: "Lesson command"
duration: "約15分"
prerequisites: ["Googleアカウントを持っている", "ブラウザが使える"]
level: "beginner"
tags: ["setup", "bigquery", "gcp", "gcloud"]
nonInteractiveMode: incompatible

BigQuery / GCP 認証セットアップ

Step 0: セットアップ進捗の確認

**AIが自動実行する内容:** 1. `uv run python tools/setup_progress.py show --current setup-bigquery` を実行して進捗を表示 2. gcloud CLI の既存インストールを自動検出:

• `gcloud --version` を実行
• gcloud CLI がインストール済み＆認証済みの場合、Step 4（接続テスト）へスキップ
• 未インストールの場合、Step 1 から開始

このセッションでやること

| 項目 | 内容 | |------|------| | ゴール | gcloud CLI をインストールし、Application Default Credentials (ADC) で認証して、BigQuery でSQLクエリを実行できるようにする | | 所要時間 | 約15分 | | 前提条件 | Googleアカウントを持っていること、ブラウザが使えること | | 操作レベル | CLIコマンド少数 + ブラウザ認証（AIが手順を案内） |

**このセッションの流れ:** 1. gcloud CLI をインストールする（AIが手順を案内） 2. Googleアカウントでログインする（ブラウザが自動で開く） 3. GCPプロジェクトを設定する（AIが案内） 4. Application Default Credentials を設定する（コマンド1つ） 5. BigQuery 接続テスト（AIが自動実行）

> **料金について**: BigQuery は月1TBまでのクエリが無料です。研修では公開データセットを使うのでほぼ無料です。無料枠を超える前にGoogleから通知が届きます。 > > **ヒント**: AIの応答が途中で止まった場合は「続きを表示して」「止まってるよ」と入力すると再開します。

---

準備チェック

**AskQuestionの設定:**

{
  "title": "セッション開始前の確認",
  "questions": [{
    "id": "readiness",
    "prompt": "準備はできていますか？",
    "options": [
      {"id": "ready", "label": "準備OK！始めましょう"},
      {"id": "check_prereq", "label": "前提条件を確認したい"},
      {"id": "different_lesson", "label": "別のレッスンに移動したい"}
    ]
  }]
}

(ready -> Step 1へ) (check_prereq -> 「Googleアカウントでブラウザにログインできれば準備OKです。BigQueryの料金は月1TBまで無料なので、研修での利用はほぼ無料です」と案内) (different_lesson -> モジュール一覧を表示)

---

Step 1: gcloud CLI のインストール

**AIが実行すること:** 1. OSを自動判定する（Mac / Windows / Linux） 2. `gcloud --version` を実行して既にインストール済みか確認する 3. インストール済みの場合は Step 2 へスキップ 4. 未インストールの場合、OS に応じたインストール手順を案内する

**Mac（Homebrew推奨）:**

brew install google-cloud-sdk

**Mac（Homebrew が使えない場合）/ Windows:** ブラウザでインストーラーをダウンロード:

# Mac:
open https://cloud.google.com/sdk/docs/install
# Windows:
start https://cloud.google.com/sdk/docs/install

**インストール後の確認:**

gcloud --version

**AskQuestionの設定:**

{
  "title": "Step 1: gcloud CLI のインストール",
  "questions": [{
    "id": "install_status",
    "prompt": "gcloud CLI のインストール状況を教えてください:",
    "options": [
      {"id": "installed", "label": "インストールしました（または既にインストール済み）"},
      {"id": "homebrew_issue", "label": "Homebrewが使えない（Mac）"},
      {"id": "windows_help", "label": "Windowsで手順がわからない"},
      {"id": "install_error", "label": "インストール中にエラーが出た"}
    ]
  }]
}

(installed -> `gcloud --version` で確認後、Step 2 へ) (homebrew_issue -> 「ブラウザで https://cloud.google.com/sdk/docs/install を開いて、macOS用のインストーラーをダウンロードしてください。ダウンロードしたファイルを展開して、./install.sh を実行すればインストールできます」と案内) (windows_help -> 「ブラウザで https://cloud.google.com/sdk/docs/install を開いて、Windows用のインストーラー（.exe）をダウンロードしてください。ダウンロードしたファイルをダブルクリックして、画面の指示に従ってインストールしてください。インストール後、新しいターミナル（WSL Ubuntu）を開いてください」と案内) (install_error -> エラーメッセージを確認して原因を特定。PATH が通っていない場合は `source ~/.zshrc` や新しいターミナルを開くよう案内)

---

Step 2: GCP プロジェクト設定

**AIが実行すること:** 1. `gcloud auth login` を実行してブラウザでGoogle認証を開始する 2. ブラウザが自動で開き、Googleアカウントでのログインを促す

gcloud auth login

**ブラウザ認証の手順をユーザーに案内:**

ブラウザが自動で開きます。以下の手順で認証してください:

┌─────────────────────────────────────────────────────────────┐
│ 1. ブラウザでGoogleアカウントを選択してログイン             │
│ 2. 「Google Cloud SDK がアクセスをリクエストしています」    │
│    → 「許可」をクリック                                     │
│ 3. 「認証が完了しました」と表示されたらブラウザを閉じてOK   │
│ 4. ターミナルに戻ると認証成功のメッセージが表示されます     │
└─────────────────────────────────────────────────────────────┘

**認証完了後、プロジェクトを設定する:**

# 既存プロジェクト一覧を表示
gcloud projects list

# プロジェクトを設定（PROJECT_IDは実際のIDに置き換え）
gcloud config set project PROJECT_ID

**AskQuestionの設定:**

{
  "title": "Step 2: GCP プロジェクト設定",
  "questions": [{
    "id": "auth_status",
    "prompt": "ブラウザでGoogleアカウント認証が完了しましたか？",
    "options": [
      {"id": "auth_done", "label": "認証が完了しました！"},
      {"id": "browser_not_open", "label": "ブラウザが開かない"},
      {"id": "auth_denied", "label": "認証画面でエラーが出た"},
      {"id": "no_project", "label": "GCPプロジェクトがない（新規作成したい）"}
    ]
  }]
}

(auth_done -> `gcloud projects list` でプロジェクト一覧を表示。既存プロジェクトがあれば `gcloud config set project PROJECT_ID` を案内して Step 3 へ) (browser_not_open -> 「ターミナルに表示されたURLをコピーして、ブラウザのアドレスバーに貼り付けてください」と案内) (auth_denied -> 「ブラウザのシークレットモード/プライベートブラウジングで試してみてください。会社のアカウントでブロックされている場合は、個人のGoogleアカウントで試してください」と案内) (no_project -> 「GCPプロジェクトを新規作成しましょう。以下のコマンドを実行します: `gcloud projects create PROJECT_ID --name="プロジェクト名"` （PROJECT_IDは英数字とハイフンで任意の名前を設定できます。例: `my-bigquery-lab`）。または https://console.cloud.google.com で新規プロジェクトを作成することもできます」と案内)

---

Step 3: Application Default Credentials (ADC) 設定

**AIが実行すること:**

1. ADC を設定するコマンドを実行:

gcloud auth application-default login

2. ブラウザが再度開き、ADC用の認証情報を作成する（Step 2 と同様にブラウザで認証）

**ユーザーに案内するメッセージ:**

もう一度ブラウザが開きます。これはPythonなどのアプリケーションから
BigQueryに接続するための認証情報（ADC）を作成するためです。

┌─────────────────────────────────────────────────────────────┐
│ 1. ブラウザでGoogleアカウントを選択してログイン             │
│ 2. 「許可」をクリック                                       │
│ 3. ターミナルに「Credentials saved to file: ...」と          │
│    表示されれば成功です                                      │
└─────────────────────────────────────────────────────────────┘

3. ADC 設定完了後、BigQuery API を有効化する:

gcloud services enable bigquery.googleapis.com

**AskQuestionの設定:**

{
  "title": "Step 3: ADC 設定",
  "questions": [{
    "id": "adc_status",
    "prompt": "ADC 認証とBigQuery API の有効化が完了しましたか？",
    "options": [
      {"id": "adc_done", "label": "「Credentials saved to file」と表示されました！"},
      {"id": "adc_browser_issue", "label": "ブラウザ認証がうまくいかない"},
      {"id": "api_enable_error", "label": "BigQuery API の有効化でエラーが出た"},
      {"id": "adc_what", "label": "ADCとは何ですか？"}
    ]
  }]
}

(adc_done -> Step 4 へ) (adc_browser_issue -> 「Step 2 と同じ手順でブラウザ認証してください。うまくいかない場合はターミナルに表示されたURLをコピーしてブラウザに貼り付けてください」と案内) (api_enable_error -> 「エラーメッセージを確認します。'permission denied' の場合、プロジェクトのオーナー権限が必要です