Google BigQuery

概要

BigQuery連携の設定

前提条件

• 連携の編集権限を持つAuxiaコンソールへのアクセス
• 連携したいBigQueryデータセットを含むGCPプロジェクト
• GCPプロジェクトでIAMロールを付与する権限。必要な権限は、選択するアクセスレベルによって異なります。

  アクセスレベル	コマンド	必要な権限	一般的なロール
  プロジェクトレベル	gcloud projects add-iam-policy-binding	resourcemanager.projects.setIamPolicy	roles/resourcemanager.projectIamAdmin
  データセットレベル	bq query 'GRANT ... ON SCHEMA'	bigquery.datasets.setIamPolicy	roles/bigquery.dataOwner または roles/bigquery.admin

ステップ1：連携

1. Auxiaコンソールでコネクション（Connections）に移動し、新しいコネクションを追加（Add New Connection）＞ BigQueryをクリックします。
2. ウィザードに、Auxiaプロジェクト固有のサービスアカウントメールが表示されます。このメールをコピーしてください。アクセス権の付与に必要です。
3. GCP Project ID（GCPプロジェクトID、例：my-analytics-project）を入力します。
4. アクセスレベルを選択します。

   アクセスレベル	説明	使用場面
   プロジェクトレベル	AuxiaがGCPプロジェクト内の既存および新規のすべてのデータセットと連携可能	シンプルな設定。ほとんどのチームに推奨
   データセットレベル	Auxiaが指定したデータセットのみと連携可能	連携するデータセットをきめ細かく制御したい場合

5. 次のいずれかの方法（CLI、GCP Console、Cloud Shell）でIAM権限を付与し、Auxiaコンソールに戻ってValidate Connection（連携を検証）をクリックします。

CLI（gcloud / bq）によるアクセス権の付与

gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/bigquery.dataViewer" \
  --condition=None

• YOUR_PROJECT_ID をGCPプロジェクトID（例：my-analytics-project）に
• SERVICE_ACCOUNT_EMAIL をAuxiaコンソールに表示されているサービスアカウントに

bq query --use_legacy_sql=false '
GRANT `roles/bigquery.dataViewer`
ON SCHEMA `YOUR_PROJECT_ID.YOUR_DATASET_NAME`
TO "serviceAccount:SERVICE_ACCOUNT_EMAIL";
'

• YOUR_PROJECT_ID をGCPプロジェクトIDに
• YOUR_DATASET_NAME をデータセットID（例：customer_360）に
• SERVICE_ACCOUNT_EMAIL をAuxiaコンソールに表示されているサービスアカウントに

GCP Console（BigQuery UI）によるアクセス権の付与

1. Google Cloud Consoleにアクセスします。
2. IAM & Admin ＞ IAMに移動します。
3. Grant Access（または上部の + Add）をクリックします。
4. New principalsフィールドに、Auxiaコンソールで表示されたサービスアカウントメールを貼り付けます。
5. Select a roleドロップダウンで、BigQuery Data Viewer（roles/bigquery.dataViewer）を検索して選択します。
6. 保存（Save）をクリックします。

1. Google Cloud Consoleにアクセスします。
2. BigQueryに移動します（左サイドバーまたは検索から）。
3. Explorerパネルで、共有したいデータセットを見つけてクリックします。
4. Sharing ＞ Permissionsをクリックします。
5. Add Principalをクリックします。
6. New principalsフィールドに、Auxiaコンソールで表示されたサービスアカウントメールを貼り付けます。
7. Select a roleドロップダウンで、BigQuery Data Viewerを検索して選択します。
8. 保存をクリックします。
9. 追加するデータセットごとに、手順3〜8を繰り返します。

Google Cloud Shellによるアクセス権の付与

1. Google Cloud Shellを開きます。
2. 正しいプロジェクトが選択されていることを確認します（gcloud config set project YOUR_PROJECT_ID）。
3. 上記のCLIセクションと同じ gcloud または bq コマンドを実行します。

ステップ2：探索とマッピング

トラブルシューティングとFAQ

アクセスと権限

• サービスアカウントメールが正しいことを確認してください（Auxiaコンソールから直接コピーしてください）。
• BigQuery Data Viewerロール（BigQuery UserやBigQuery Adminではなく）を付与したことを確認してください。
• データセットレベルのアクセスの場合、各データセットに個別にアクセス権を付与したことを確認してください。

gcloud projects get-iam-policy YOUR_PROJECT_ID \
  --flatten="bindings[].members" \
  --filter="bindings.members:serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --format="table(bindings.role)"

bq show --format=prettyjson YOUR_PROJECT_ID:YOUR_DATASET_NAME | grep -A5 "access"

• 必要なロールを付与してもらう、または
• gcloud / bq コマンドを代わりに実行してもらう（Auxiaコンソールのウィザードからコマンドを共有してください）。

一般