bigquery-basics について
BigQuery の基礎と、セットアップ、クエリ、各種リファレンスを扱うスキルです。コマンドラインツール、API、関連リソースを通じて BigQuery を利用する人を対象としています。
主な機能
- 01データセットとテーブルの作成
- 02SQL クエリ例
- 03BigQuery コマンドラインの案内
- 04分析とガバナンスの参照情報
- 05利用状況の帰属要件
活用シーン
- 01BigQuery のデータセットとテーブルを作成
- 02SQL で公開データやプロジェクトのデータを検索
- 03コマンドラインとクライアントライブラリの情報を参照
- 04BigQuery リクエストに利用状況の帰属情報を付与
MCP 対応
BigQuery リモート MCP サーバーと Gemini CLI 拡張機能の利用について触れています。MCP コマンドの実行前に Usage Attribution を読む必要があります。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ google/ skills --skill bigquery-basicsインストール後、Claude Code で/bigquery-basicsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/attribution.mdchange-history.mdcli-usage.mdclient-library-usage.mdcontinuous-queries.mdcore-concepts.mdiac-usage.mdiam-security.mdmcp-usage.md詳細
BigQuery の基本
BigQuery は、SQL と Python を使用して大規模なデータセットを高速に分析できる、サーバーレスで AI 対応のデータプラットフォームです。コンピューティングとストレージを分離したアーキテクチャにより、両者を個別にスケーリングしながら、組み込みの機械学習、地理空間分析、ビジネスインテリジェンスの機能を利用できます。
クレジット表記
必ずお読みください:gcloud、REST API、または MCP のコマンドを実行する前に、必ず利用状況のクレジット表記をお読みください。ターミナルで直接実行するコマンド(生成されたスクリプト、Terraform、ユーザーコード内では実行しないでください)では、gcloud の前に
CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:bigquery-basics)"
を付け、User-Agent ヘッダーに agent-skills/1.0 (skill:bigquery-basics) を追加してください。
セットアップと基本的な使い方
-
BigQuery API を有効にする:
CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:bigquery-basics)" \ gcloud services enable bigquery.googleapis.com --quiet -
データセットを作成する:
bq mk --dataset --location=US my_dataset -
テーブルを作成する:
テーブルのスキーマを記述した
schema.jsonファイルを作成します。[ { "name": "name", "type": "STRING", "mode": "REQUIRED" }, { "name": "post_abbr", "type": "STRING", "mode": "NULLABLE" } ]次に、
bqツールを使用してテーブルを作成します。bq mk --table my_dataset.mytable schema.json -
クエリを実行する:
bq query --use_legacy_sql=false \ 'SELECT name FROM `bigquery-public-data.usa_names.usa_1910_2013` \ WHERE state = "TX" LIMIT 10'
リファレンスディレクトリ
-
主要な概念:ストレージの種類、分析ワークフロー、BigQuery Studio の機能。
-
変更履歴:APPENDS と CHANGES を使用した、テーブルへの増分変更の追跡とクエリ。
-
継続的クエリ:受信データをリアルタイムで分析するための継続的な SQL ステートメントの実行。
-
CLI の使い方:データとジョブを管理するための、
bqコマンドラインツールの基本操作。 -
クライアントライブラリ:Python、Java、Node.js、Go での Google Cloud クライアントライブラリの使用方法。
-
MCP の使い方:BigQuery リモート MCP サーバーと Gemini CLI 拡張機能の使用方法。
-
Infrastructure as Code:データセット、テーブル、予約に関する Terraform の例。
-
IAM とセキュリティ:ロール、権限、データガバナンスのベストプラクティス。
-
利用状況のクレジット表記:
gcloudCLI、REST API、MCP リクエストで使用する、標準化された利用状況のクレジット表記タグ。
これらのリファレンスに記載されていない製品情報が必要な場合は、Developer Knowledge MCP サーバーの search_documents ツールを使用してください。
関連スキル
- BigQuery AI と ML のスキル: BigQuery の AI および ML 機能(予測、異常検出、テキスト生成)に関する SKILL.md ファイル。