Documentation

Query Google Cloud Bigtable

To query Google Cloud Bigtable with Flux:

  1. Import the experimental/bigtable package.

  2. Use bigtable.from and provide the following parameters:

    • token: Google Cloud IAM token
    • project: Bigtable project ID
    • instance: Bigtable instance ID
    • table: Bigtable table to query
import "experimental/bigtable"

bigtable.from(
    token: "mySuPeRseCretTokEn",
    project: "exampleProjectID",
    instance: "exampleInstanceID",
    table: "example-table",
)

Results structure

bigtable.from() returns a stream of tables with no grouping (all rows in a single table). For more information about table grouping, see Flux data model - Restructure tables.

Store sensitive credentials as secrets

If using InfluxDB Cloud or InfluxDB OSS 2.x, we recommend storing Bigtable connection credentials as InfluxDB secrets. Use secrets.get() to retrieve a secret from the InfluxDB secrets API.

import "experimental/bigtable"
import "influxdata/influxdb/secrets"

bigtable_token = secrets.get(key: "BIGTABLE_TOKEN")
bigtable_project = secrets.get(key: "BIGTABLE_PROJECT_ID")
bigtable_instance = secrets.get(key: "BIGTABLE_INSTANCE_ID")

bigtable.from(
    token: bigtable_token,
    project: bigtable_project,
    instance: bigtable_instance,
    table: "example-table"
)

Was this page helpful?

Thank you for your feedback!


New in InfluxDB 3.6

Key enhancements in InfluxDB 3.6 and the InfluxDB 3 Explorer 1.4.

See the Blog Post

InfluxDB 3.6 is now available for both Core and Enterprise. This release introduces the 1.4 update to InfluxDB 3 Explorer, featuring the beta launch of Ask AI, along with new capabilities for simple startup and expanded functionality in the Processing Engine.

For more information, check out:

InfluxDB Docker latest tag changing to InfluxDB 3 Core

On February 3, 2026, the latest tag for InfluxDB Docker images will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments.

If using Docker to install and run InfluxDB, the latest tag will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments. For example, if using Docker to run InfluxDB v2, replace the latest version tag with a specific version tag in your Docker pull command–for example:

docker pull influxdb:2