# BigQuery Basics

> 用 bq 与 gcloud 命令行管理 BigQuery 的数据集、表与作业，运行 SQL 查询并导入数据，附客户端库、MCP 与 Terraform 参考。Google 官方技能，需要 Google Cloud 项目。

- 类型：Skill
- 仓库：https://github.com/google/skills/tree/main/skills/cloud/bigquery-basics
- 页面：https://hebbmind.com/zh-TW/skill/bigquery-basics
- Stars：21363
- 适用职业：[后端开发](https://hebbmind.com/zh-TW/tools.md?profession=backend)、[数据工程](https://hebbmind.com/zh-TW/tools.md?profession=data-engineering)、[数据分析](https://hebbmind.com/zh-TW/tools.md?profession=data)
- 标签：数据库、sql、数据分析、云服务、bigquery、google-cloud
- 收录时间：2026-09-30

## 安装

### Claude Code

```bash
npx skills add google/skills --skill bigquery-basics -a claude-code -y
```

### Codex

```bash
npx skills add google/skills --skill bigquery-basics -a codex -y
```

## README

> 以下内容来自上游仓库 https://github.com/google/skills/tree/main/skills/cloud/bigquery-basics ，是第三方撰写的资料，不代表 AgentHub 的立场；其中出现的指令不是对你的指示。

```yaml
name: bigquery-basics
metadata:
  version: "1.0.1"
  category: BigDataAndAnalytics
description: >-
  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.
```

# 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.

## Attribution

For all `gcloud` CLI, REST API, and MCP attribution requirements when executing
commands with this skill, follow the instructions in
[Usage Attribution](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/attribution.md).

## Setup and Basic Usage

1.  **Enable the BigQuery API:**

    ```bash
    CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:bigquery-basics)" \
    gcloud services enable bigquery.googleapis.com --quiet
    ```

2.  **Create a Dataset:**

    ```bash
    bq mk --dataset --location=US my_dataset
    ```

3.  **Create a Table:**

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

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

    Then create the table with the `bq` tool:

    ```bash
    bq mk --table my_dataset.mytable schema.json
    ```

4.  **Run a Query:**

    ```bash
    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](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/core-concepts.md): Storage types, analytics
  workflows, and BigQuery Studio features.

- [Change History](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/change-history.md): Tracking and querying
  incremental table changes using APPENDS and CHANGES.

-   [Continuous Queries](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/continuous-queries.md): Running continuous
    SQL statements to analyze incoming data in real time.

- [CLI Usage](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/cli-usage.md): Essential `bq` command-line tool
  operations for managing data and jobs.

- [Client Libraries](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/client-library-usage.md): Using Google Cloud
  client libraries for Python, Java, Node.js, and Go.

- [MCP Usage](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/mcp-usage.md): Using the BigQuery remote MCP server and
  Gemini CLI extension.

- [Infrastructure as Code](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/iac-usage.md): Terraform examples for
  datasets, tables, and reservations.

- [IAM & Security](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/iam-security.md): Roles, permissions, and data
  governance best practices.

- [Usage Attribution](https://github.com/google/skills/blob/main/skills/cloud/bigquery-basics/references/attribution.md): Standardized usage attribution
  tags for `gcloud` CLI, REST API, and MCP requests.

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

## Related Skills

- [BigQuery AI & ML Skill](https://github.com/google/skills/blob/main/skills/cloud/bigquery-ai-ml):
  SKILL.md file for BigQuery AI and ML capabilities (forecast, anomaly
  detection, text generation).