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,
)
Deleted tags
Tags explicitly deleted from InfluxDB do not appear in results.
Expired tags
- InfluxDB Cloud: tags associated with points outside of the bucket’s retention policy may appear in results up to an hour after expiring.
- InfluxDB OSS: tags associated with points outside of the bucket’s retention policy may appear in results. For more information, see Data retention in InfluxDB OSS.
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)
Not supported in the Flux REPL
schema
functions can retrieve schema information when executed within
the context of InfluxDB, but not from the Flux REPL.
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for Flux and this documentation. To find support, use the following resources:
InfluxDB Cloud customers can contact InfluxData Support.