---
title: Query Google Cloud Bigtable
description: Use bigtable.from to query Google Cloud Bigtable with Flux.
url: https://docs.influxdata.com/flux/v0/query-data/bigtable/
estimated_tokens: 1419
product: Flux
version: v0
---

# Query Google Cloud Bigtable

To query [Google Cloud Bigtable](https://cloud.google.com/bigtable/) with Flux:

1. Import the [`experimental/bigtable` package](/flux/v0/stdlib/experimental/bigtable/).
    
2. Use [`bigtable.from`](/flux/v0/stdlib/experimental/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

```js
import "experimental/bigtable"

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

## Results structure

`bigtable.from()` returns a [stream of tables](/flux/v0/get-started/data-model/#stream-of-tables) with no grouping (all rows in a single table). For more information about table grouping, see [Flux data model - Restructure tables](/flux/v0/get-started/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](/influxdb/cloud/admin/secrets/). Use [`secrets.get()`](/flux/v0/stdlib/influxdata/influxdb/secrets/get/) to retrieve a secret from the InfluxDB secrets API.

```js
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"
)
```

#### Related

-   [bigtable.from() function](/flux/v0/stdlib/experimental/bigtable/from/)
-   [Cloud Bigtable Access Control](https://cloud.google.com/bigtable/docs/access-control)
-   [Google Cloud IAM How-to guides](https://cloud.google.com/iam/docs/how-to)
-   [Setting Up Authentication for Production Applications on Google Cloud](https://cloud.google.com/docs/authentication/production)