bigquery-api

Runs BigQuery SQL queries and browses datasets, tables, and jobs via REST API.

37|13|Updated Jun 23, 2026
One-click install
npx skills add https://github.com/anthropics/claude-tag-plugins --skill bigquery-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bigquery-api
Source: https://github.com/anthropics/claude-tag-plugins/tree/main/bigquery/skills/bigquery-api
Command: npx skills add https://github.com/anthropics/claude-tag-plugins --skill bigquery-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill removes the manual work of querying BigQuery, monitoring jobs, and browsing datasets or tables through the REST API, so you can get answers and catalog details quickly.

Core Features & Use Cases

  • Run SQL queries: Submit synchronous or asynchronous BigQuery queries, poll job status, and page through large result sets.
  • Browse catalog metadata: List datasets and tables, inspect schemas, and preview rows without running a query job.
  • Manage query jobs: Check recent jobs, cancel a running job, and handle location-aware polling and pagination correctly.
  • Use case: Ask it to find the largest values in a table, verify what tables exist in a dataset, or confirm whether a long-running job finished successfully.

Quick Start

Ask the assistant to run a BigQuery query for your project or to inspect the datasets, tables, or schema for a specific BigQuery resource.

Frequently Asked Questions about bigquery-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run synchronous and asynchronous BigQuery SQL queries via the REST API?

To run BigQuery SQL queries, submit synchronous or asynchronous jobs, poll their status, and page through large result sets. The tool handles parameterized SQL and location-aware job polling to retrieve answers.

How do I browse BigQuery datasets, table schemas, and preview rows without running a query job?

You can browse BigQuery catalog metadata by listing datasets and tables, inspecting schemas, and previewing rows directly. This allows you to verify table structures without executing a query job.

What's the best way to check recent BigQuery jobs and cancel a running job?

The best way to manage BigQuery jobs is to check recent job statuses and cancel running jobs. It handles location-aware polling and pagination correctly to confirm whether a long-running job finished successfully.

Do I need curl and jq to inspect BigQuery tables and execute queries?

Yes, you need curl and jq to inspect BigQuery tables and execute queries. These dependencies handle Google BigQuery REST API calls and decode API responses to retrieve data.

Are there guardrails for maximum bytes processed when running BigQuery SQL?

Yes, there are maximum-bytes guardrails applied when running BigQuery SQL. These limits prevent excessive data scanning during query execution and job polling.

How does location-aware job polling work for asynchronous BigQuery queries?

Location-aware job polling checks the status of asynchronous BigQuery queries by targeting the specific geographic location where the job runs, ensuring accurate status retrieval and result paging.