influxdb.cardinality()函数
influxdb.cardinality()返回从InfluxDB检索到的数据系列基数。
尽管此函数与InfluxQL的SHOW SERIES CARDINALITY类似，但它们的工作方式略有不同。
influxdb.cardinality()是时间有限的，并报告符合传入条件的数据的基数，而不是整个桶的基数。
函数类型签名
(
start: A,
?bucket: string,
?bucketID: string,
?host: string,
?org: string,
?orgID: string,
?predicate: (r: {B with _value: C, _measurement: string, _field: string}) => bool,
?stop: D,
?token: string,
) => stream[{_value: int, _stop: time, _start: time}] where A: Timeable, D: Timeable
更多信息请参见函数类型签名。
参数
bucket
查询基数的桶。
bucketID
用于查询基数的字符串编码桶ID。
org
组织名称。
orgID
字符串编码的组织ID。
host
要查询的InfluxDB实例的URL。
请参阅InfluxDB Cloud区域或InfluxDB OSS URL。
token
InfluxDB API令牌。
start
(必需) 计算基数时包含的最早时间。
基数计算包括与指定开始时间匹配的点。使用相对持续时间或绝对时间。例如，-1h或2019-08-28T22:00:00Z。持续时间相对于now()。
stop
计算基数时包含的最晚时间。
基数计算不包括与指定开始时间匹配的点。使用相对持续时间或绝对时间。例如，-1h或2019-08-28T22:00:00Z。持续时间相对于now()。默认值是now()。
默认值是now()，因此除非提供未来的stop日期，否则不会计算写入未来的任何点。
predicate
用于筛选记录的谓词函数。默认为(r) => true。
示例
查询桶中的系列基数
import "influxdata/influxdb"
influxdb.cardinality(bucket: "example-bucket", start: time(v: 1))
注意：如果已写入未来的点，则需要添加适当的stop日期
查询测量中的系列基数
import "influxdata/influxdb"
influxdb.cardinality(
bucket: "example-bucket",
start: time(v: 1),
predicate: (r) => r._measurement == "example-measurement",
)
查询特定标签的系列基数
import "influxdata/influxdb"
influxdb.cardinality(bucket: "example-bucket", start: time(v: 1), predicate: (r) => r.exampleTag == "foo")
查询过去4小时内写入的数据的基数
import "influxdata/influxdb"
influxdb.cardinality(bucket: "example-bucket", start: -4h)
这个页面有帮助吗？
感谢您的反馈！