v1.tagValues() function
v1.tagValues()
was deprecated in Flux v0.88.0 in favor of
schema.tagValues()
.
The v1.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/v1"
v1.tagValues(
bucket: "example-bucket",
tag: "host",
predicate: (r) => true,
start: -30d
)
Parameters
bucket
Bucket to return unique tag values from.
Data type: String
tag
Tag to return unique values from.
Data type: String
predicate
Predicate function that filters tag values.
Defaults to (r) => true
.
Data type: Function
start
Oldest time to include in results.
Defaults to -30d
.
Relative start times are defined using negative durations. Negative durations are relative to now. Absolute start times are defined using time values.
Data type: Duration
Examples
import "influxdata/influxdb/v1"
v1.tagValues(
bucket: "my-bucket",
tag: "host",
)
Function definition
package v1
tagValues = (bucket, tag, predicate=(r) => true, start=-30d) =>
from(bucket: bucket)
|> range(start: start)
|> filter(fn: predicate)
|> group(columns: [tag])
|> distinct(column: tag)
|> keep(columns: ["_value"])
Used functions: from, range, filter, group, distinct, keep
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, the following resources are available:
InfluxDB Cloud and InfluxDB Enterprise customers can contact InfluxData Support.