Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
docs-v2/content/flux/v0.x/query-data/bigtable.md

2.4 KiB
Raw Blame History

title list_title description menu weight related list_code_example
Query Google Cloud Bigtable Google Cloud Bigtable Use [`bigtable.from`](/flux/v0.x/stdlib/experimental/bigtable/from) to query [Google Cloud Bigtable](https://cloud.google.com/bigtable/) with Flux.
flux_0_x
name parent
Bigtable Query data sources
104
/flux/v0.x/stdlib/experimental/bigtable/from/
https://cloud.google.com/bigtable/docs/access-control, Cloud Bigtable Access Control
https://cloud.google.com/iam/docs/how-to, Google Cloud IAM How-to guides
https://cloud.google.com/docs/authentication/production, Setting Up Authentication for Production Applications on Google Cloud
```js import "experimental/bigtable" bigtable.from(url: "http://example.com/metrics") ```

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