goccy/bigquery-emulator

Health v2 · maintenance only

Adoption not part of the score

1134 stars · 182 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A BigQuery emulator server implemented in Go that runs a BigQuery-compatible API locally without needing a cloud project or credentials. It uses SQLite for storage, supports GoogleSQL query execution, and can run as a standalone binary, in Docker, or in-process with Go tests via httptest.

Use cases

• run BigQuery queries locally without a GCP project
• test applications against a BigQuery-compatible API in CI
• develop and debug BigQuery SQL offline
• load seed data from YAML for integration tests
• use the bq CLI against a local fake BigQuery server
• test official BigQuery client libraries from Python, Java, Node.js, Ruby, or PHP

When to choose

• you need fast, free local testing of BigQuery-dependent code
• you want to run integration tests in CI without cloud credentials
• you develop in a language with an official BigQuery client and need a local server endpoint

When to avoid

• you need IAM policies, row access policies, copy jobs, external tables, table snapshots, or BigQuery ML
• you require exact parity with production BigQuery performance or full feature coverage
• you need a fully GA-supported emulator for critical production-like validation

Facets

service · maturity active

http-server database testing developer-tools databases developer-tools testing cloud-computing go cli cross-platform bigquery emulator gcp google-cloud sqlite local-testing mock-server docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="goccy/bigquery-emulator")