Catalog
google/bigquery-basics

google

bigquery-basics

Manages datasets, tables, and jobs in BigQuery. Use when you need to interact with BigQuery, run SQL queries, manage BigQuery resources (datasets, tables, views), or perform basic data ingestion and analysis.

global
category:BigDataAndAnalytics
New~604
v2.0Saved Jun 28, 2026

BigQuery Basics

BigQuery is a serverless, AI-ready data platform that enables high-speed analysis of large datasets using SQL and Python. Its disaggregated architecture separates compute and storage, allowing them to scale independently while providing built-in machine learning, geospatial analysis, and business intelligence capabilities.

Setup and Basic Usage

  1. Enable the BigQuery API:

    gcloud services enable bigquery.googleapis.com --quiet
    
  2. Create a Dataset:

    bq mk --dataset --location=US my_dataset
    
  3. Create a Table:

    Create a file named schema.json with your table schema:

    [
      {
        "name": "name",
        "type": "STRING",
        "mode": "REQUIRED"
      },
      {
        "name": "post_abbr",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
    

    Then create the table with the bq tool:

    bq mk --table my_dataset.mytable schema.json
    
  4. Run a Query:

    bq query --use_legacy_sql=false \
    'SELECT name FROM `bigquery-public-data.usa_names.usa_1910_2013` \
    WHERE state = "TX" LIMIT 10'
    

Reference Directory

  • Core Concepts: Storage types, analytics workflows, and BigQuery Studio features.

  • CLI Usage: Essential bq command-line tool operations for managing data and jobs.

  • Client Libraries: Using Google Cloud client libraries for Python, Java, Node.js, and Go.

  • MCP Usage: Using the BigQuery remote MCP server and Gemini CLI extension.

  • Infrastructure as Code: Terraform examples for datasets, tables, and reservations.

  • IAM & Security: Roles, permissions, and data governance best practices.

If you need product information not found in these references, use the Developer Knowledge MCP server search_documents tool.

  • BigQuery AI & ML Skill: SKILL.md file for BigQuery AI and ML capabilities (forecast, anomaly detection, text generation).
Files7
7 files · 24.7 KB

Select a file to preview

Overall Score

84/100

Grade

B

Good

Safety

82

Quality

88

Clarity

85

Completeness

80

Summary

This skill provides foundational guidance for managing BigQuery datasets, tables, and jobs. It covers setup, CLI usage, client library integration across Python/Java/Node.js/Go, MCP server configuration, Infrastructure as Code with Terraform, and IAM/security best practices. The skill is well-structured with reference documents covering core concepts, pricing, and data governance.

Detected Capabilities

shell execution (gcloud, bq CLI)file write (schema.json, Terraform configs)external service access (Google Cloud APIs)documentation reference (links to official docs)code examples (Python, Java, Node.js, Go, SQL, HCL)

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

run bigquery querycreate bigquery datasetbigquery table managementbigquery terraform deploybigquery security setup

Risk Signals

INFO

gcloud services enable bigquery.googleapis.com calls Google Cloud APIs

SKILL.md Setup section
INFO

bq mk, bq query, bq load commands interact with external BigQuery service

references/cli-usage.md
INFO

Reference links point to official Google Cloud documentation

SKILL.md and all reference files
INFO

Client libraries use default Google Cloud authentication (GOOGLE_APPLICATION_CREDENTIALS or service account)

references/client-library-usage.md

Referenced Domains

External domains referenced in skill content, detected by static analysis.

ai.google.devcloud.google.comdataframes.bigquery.devdocs.cloud.google.comgithub.comgoogleapis.devmcp-toolbox.devregistry.terraform.iowww.apache.org

Use Cases

  • Create and manage BigQuery datasets and tables
  • Execute SQL queries and analyze large datasets
  • Integrate BigQuery with Python, Java, Node.js, or Go applications
  • Provision BigQuery infrastructure using Terraform
  • Configure IAM roles and implement column/row-level security
  • Set up BigQuery MCP server for agent-based data management
  • Monitor and optimize BigQuery jobs and costs

Quality Notes

  • Excellent structure: main SKILL.md provides overview with clear setup steps, then delegates to focused reference documents
  • Comprehensive coverage: includes CLI, SDKs (4 languages), MCP, Terraform, and security—well-suited for both interactive and programmatic workflows
  • Security-aware: dedicated IAM & Security reference document covers least privilege, encryption, VPC controls, and row/column-level masking
  • All external documentation links are to official Google Cloud sources (ai.google.dev, cloud.google.com, docs.cloud.google.com, googleapis.dev)
  • Examples are practical and runnable: schema.json template, Terraform HCL with resource definitions, Python/Java/Node.js/Go snippets all immediately usable
  • Setup is gated: requires authentication (gcloud SDK) and explicit API enablement—no unguarded access
  • MCP reference is forward-looking: acknowledges Model Context Protocol as a data management pattern for agents
  • Completeness: all referenced files are present in the manifest; no dangling links within the skill directory
Model: claude-haiku-4-5-20251001Analyzed: Jun 28, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Version History

  1. v2.0

    Contract changed: description

    ✦ AINarrows skill scope from ML and Gemini to basic dataset, table, and query operations; removes cross-referenced AI & ML skill links.

    triggering2026-06-28

    Latest
  2. v1.0

    2026-05-02

    Initial version

Use google/bigquery-basics in your dev environment

Command Palette

Search for a command to run...