Plugins 〉Google BigQuery


Developer

Grafana Labs

Sign up to receive occasional product news and updates:



Data Source
grafana

Google BigQuery

Documentation →

Google BigQuery data source for Grafana

The Google BigQuery data source plugin allows you to query and visualize Google BigQuery data from within Grafana.

Documentation

For complete documentation, refer to Google BigQuery data source documentation.

Installation

  1. Navigate to the BigQuery plugin page on Grafana.
  2. Click Install plugin.

For detailed installation and configuration instructions, refer to Configure the data source.

Requirements

The following Google APIs must be enabled in your GCP project:

Get help

Installing Google BigQuery on Grafana Cloud:

For more information, visit the docs on plugin installation.

Changelog

3.1.3

🐛 chore: pass X-Plugin-Id as label

3.1.2

🐛 Fix: Prevent panic on missing ResourceManagerService

⚙️ Updated backend/go version to 1.26.0 from 1.25.6 which resolves CVE-2025-68121

⚙️ Updated frontend & backend dependencies

3.1.1

🐛 Fix: Bug introduced in 3.1.0 that prevented queries from running

3.1.0

🚀 Update dependencies for react-19 upgrade

3.0.4

🐛 Fix the filters in visual query builder for timestamp/date filters ( Fixes #381 ) 🐛 Fix: Add filter needs to be clicked 2 times

3.0.3

🐛 bump sqlds

3.0.2

🐛 Fix: Panic invalid memory address or nil pointer dereference

3.0.1

🐛 Fix: Error source for query data and bump sqlds 5.0.1

3.0.0

🎉 Sets the least supported version of Grafana to 11.6.x, and updates @grafana package dependencies accordingly Removes warnings for deprecated functions and components (i.e. Select -> ComboBox, substr -> substring etc), some warnings were removed by disabling lint warnings due to incompatibility of migration at the moment Updates docs and tests as well as prettier config for import sorting

🚀 Feat: Add support to run queries with Storage API

🐛 Enhance error logging and handling

🐛 Fix: Add support for JSON, RANGE, INTERVAL types

2.2.1

🐛 Fix: Return downstream error when query fails

2.2.0

🚀 Feat: Add OAuth passthrough

🐛 Bump github.com/grafana/grafana-google-sdk-go to 0.4.2

2.1.0

🚀 Feat: Support service account impersonation ⚙️ Bump github.com/getkin/kin-openapi from 0.129.0 to 0.131.0

2.0.5

⚙️ Update golang.org/x/net from 0.36.0 to 0.38.0 ⚙️ Update prismjs to 1.30.0

2.0.4

🐛 Improve health check by returning errors properly ⚙️ Update golang.org/x/net from 0.35.0 to 0.36.0 ⚙️ Update frontend dependencies

2.0.3

⚙️ Update github.com/grafana/grafana-plugin-sdk-go to 0.268.0 ⚙️ Update frontend dependencies

2.0.2

⚙️ Bump github.com/grafana/grafana-plugin-sdk-go to 0.263.0

2.0.1

  • Chore: Update release workflow

2.0.0

  • Chore: Plugin now requires Grafana 10.4.8 or newer

1.9.3

  • Chore: Bump uplot from 1.6.31
  • Chore: Bump github.com/grafana/grafana-plugin-sdk-go from 0.250.0 to 0.258.0

1.9.2

  • Chore: Bump path-to-regexp from 1.8.0 to 1.9.0 (#296)
  • Chore: Bump github.com/grafana/grafana-plugin-sdk-go from 0.245.0 to 0.250.0 (#297)
  • Chore: Bump dompurify from 3.1.0 to 3.1.6 (#298)

1.9.1

  • Chore: Update github.com/grafana/grafana-plugin-sdk-go to v0.245.0 (#293)
  • Chore: Update micromatch from 4.0.5 to 4.0.8 (#292)
  • Chore: Update webpack from 5.86.0 to 5.94.0 (#291)

1.9.0

  • Feature: Add support for custom service endpoint (#266)
  • Chore: Add logging for custom service endpoint (#286)
  • Chore: Update github.com/grafana/grafana-plugin-sdk-go to v0.241.0 (#285)

1.8.0

  • Fix: Make editor labels clickable (#276)
  • Chore: Plugin now requires Grafana 10.3.6 or newer (#275)

1.7.1

  • Fix: Remove change incompatible with grafana9 (#273)

1.7.0

  • Feature: Allow specifying Max Billable Bytes (#254)
  • Fix: Handle sub-second intervals in the timeGroup macro (#262)
  • Fix: Fixed log line formatting (#255)
  • Fix: Make editor labels clickable (#256)
  • Fix: Update docs to list correct macros (#259)
  • Chore: Update dependencies (#264)
  • Chore: Consistent icons (#261)

1.6.1

  • Chore: Update dependencies

1.6.0

  • Chore: Update dependencies, plugin keywords
  • Feature: Query editor: Automatic location selection (#244)
  • Feature: Query editor: Better project selection flow (#239)

1.5.0

  • Chore: Add missing processing locations (#231)
  • Feature: Hide sensitive project information from the Frontend (#236)
  • Chore: Update create-plugin and dependencies #240
  • Feature: Attach grafana-http-headers as config labels for queries (#241)

1.4.1

  • Feature: Add macros autocomplete for code editor
  • Feature: Update configuration page to follow best practices
  • Chore: Upgrade grafana-plugin-sdk-go to latest

1.4.0

  • Chore: Update go and npm dependencies.
  • Fix: Fix A11y issues in the query editor.
  • Feature: Add support for querying databases from drive.

1.3.1

  • Chore: Update the grafana-plugin-sdk-go to 0.171.0

1.3.0

  • Feature: Add support for PDC.

1.2.9

  • Chore: Use SQLDS in every plugin instance.

1.2.8

  • Fix: Variable query error because missing refId #180

1.2.7

  • Chore: Update variable editor to use new API. This will also fix an issue with timeFilter macro. #174

1.2.6

  • Chore - Backend binaries are now compiled with golang 1.20.4

1.2.5

  • Chore: Bump go version

1.2.4

  • Chore: Upgrade to latest grafana-google-sdks #166
  • Chore: Migrate to create-plugin #165
  • Added processing locations: Columbus (Ohio), Madrid, Milan and Paris #161

1.2.3

  • Chore: Upgrade grafana/experimental to 1.0.1 #144
  • Fix: Update time macros to unquote time variables #155
  • Fix: Don't panic in macro timegroup #156

1.2.2

  • Chore: Update to Golang 1.19 #149

1.2.1

  • Querying: Fix an issue when query location would not be set correctly. (#140)

1.2.0

  • Datasource config: Add support for using private key path in datasource configuration.

1.1.1

  • Fix: Compatibility issue with Grafana version 8.0.0. (#121)

1.1.0

This release comes with a new feature that enables using multiple BigQuery projects using a single data source. In order to see GCP projects listed in the query editor, you need to enable the Google Cloud Resource Manager API.

  • Feature: Add support for multi-project setup. (#112)
  • Chore: Update @grafana/experimental dependency. (#115)
  • Fix: Processing location is no longer reset when code editor query changes. (#114)

1.0.3

  • Data types support: Add support for querying array of primitive types.
  • Fix: Interpolate $__interval and $__interval_ms variables when validating query.

1.0.2

  • Fix: Use configured default project when using GCE authentication.

1.0.1

  • Authentication: Allow configuring default project when using GCE authentication.

1.0.0

0.1.15

  • Data types support Add support for GEOGRAPHY, BIGNUMERIC and BYTES data types.
  • Code editor: Add possibility to edit query in an expanded editor.
  • Visual Query Builder: Support asterisk in select.
  • Visual Query Builder: Format preview.
  • Visual Query Builder: Open group by when aggregation selected.
  • Fix: Reset query on dataset change.
  • Fix: Remove not used config settings.
  • Fix: Perform query validation on processing location change.
  • Update list of available processing locations.
  • Update minimal Grafana version.

0.1.14

  • Fix: Reset query in visual query builder when table is changed.
  • Fix: Remove debounced state updates in visual query builder.
  • Fix: Format template variables and macros correctly in code editor.
  • Fix: Do not run hidden queries.
  • Fix: Interpolate template variables correctly for validation requests.

0.1.13

  • Data source settings: Fix bug, that made it impossible to reset and change JWT token used for authentication.

0.1.12

  • Annotations: Add annotation support.
  • Visual Query Builder: Visual query builder has now a default limit set for a query (50).
  • Visual Query Builder: Queries built with visual query builder are no longer automatically executed- the Run query button is shown as in code editor.
  • Visual Query Builder: Query produced by visual query builder has table wrapped in backticks.
  • Visual Query Builder: Add aggregated columns to Order By select.
  • Visual Query Builder: Fix bug when the user changes the filter operator.
  • Autocomplete: Add completion for macros.
  • Query validation: Add time range to query validation API call. Fixes query validation errors when macros using the time range is used.
  • Query validation: Return validation when an unsupported macro is used.
  • Fix: timeGroup macro should now be interpolated correctly.

0.1.11

  • Fix: Allow running script queries.
  • Query validation: Add interpolated to validation response.

0.1.10

  • Code editor: Add option to format the query.
  • Code editor: Do not run the query when user blurs the code editor.
  • Query validation: Do not re-validate query if it hasn't changed.

0.1.9

  • Autocomplete: Add suggestions for columns in WHERE clause.
  • Query validation: Actively run query validation on query change rather than on blur.
  • Code editor: Run query when CTRL/CMD+Return is pressed.

0.1.8

  • Autocomplete: Improve tables suggestions.
  • Query validation: Interpolate template variables and macros before performing dry run.

0.1.7

  • Autocomplete: Add suggestions for ingestion-time partitioned table filters.
  • Code editor: Make autocomplete case insensitive for keywords and operators.
  • Code editor: Make query bytes estimate more user friendly.

0.1.6

  • Code editor: Add validation with query dry run.

0.1.5

  • Autocomplete: Fixed the broken dataset/table suggestions.

0.1.4

  • Visual Query Builder: Introducing visual query builder.
  • Code editor: Make raw query editor work in Grafana < 8.2.x.

0.1.3

  • Autocomplete: Deduplicate logical operators.
  • Code editor: Do not run query on blur, improve query header component.

0.1.2

  • Data types support: Handle NUMERIC data type.

0.1.1

  • Autocomplete: Fixed the broken dataset/table suggestions if project id or dataset id contains a keyword defined in Monaco's default SQL language definition.

0.1.0

Initial Beta release.