schema.tagValues() function

The schema.tagValues() function returns a list of unique values for a given tag. The return value is always a single table with a single column, _value.

import "influxdata/influxdb/schema"

schema.tagValues(
    bucket: "example-bucket",
    tag: "host",
    predicate: (r) => true,
    start: -30d,
)

Parameters

bucket

Bucket to return unique tag values from.

tag

Tag to return unique values from.

predicate

Predicate function that filters tag values. Default is (r) => true.

start

Earliest time to include in results. Default is -30d.

Relative start times are defined using negative durations. Negative durations are relative to now(). Absolute start times are defined using time values.

stop

Latest time to include in results. Default is now().

The stop time is exclusive, meaning values with a time equal to stop time are excluded from results. Relative start times are defined using negative durations. Negative durations are relative to now(). Absolute start times are defined using time values.

Examples

Return all values for a tag in a bucket

import "influxdata/influxdb/schema"

schema.tagValues(bucket: "example-bucket", tag: "host")

Return all tag values in a bucket during a non-default time range

import "influxdata/influxdb/schema"

schema.tagValues(bucket: "example-bucket", tag: "host", start: -90d, stop: -60d)