docs-v2/content/flux/v0/stdlib/influxdata/influxdb/schema/fieldkeys.md

2.4 KiB

title description menu weight flux/v0/tags
schema.fieldKeys() function `schema.fieldKeys()` returns field keys in a bucket.
flux_v0_ref
name parent identifier
schema.fieldKeys influxdata/influxdb/schema influxdata/influxdb/schema/fieldKeys
301
metadata

schema.fieldKeys() returns field keys in a bucket.

Results include a single table with a single column, _value.

Note: FieldKeys is a special application of tagValues() that returns field keys in a given bucket.

Function type signature
(
    bucket: string,
    ?predicate: (
        r: {
            A with
            _value: B,
            _time: time,
            _stop: time,
            _start: time,
            _measurement: string,
            _field: string,
        },
    ) => bool,
    ?start: C,
    ?stop: D,
) => stream[E] where E: Record

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

bucket

({{< req >}}) Bucket to list field keys from.

predicate

Predicate function that filters field keys. Default is (r) => true.

start

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

stop

Newest time include in results. The stop time is exclusive, meaning values with a time equal to stop time are excluded from the results. Default is now().

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

Examples

Query field keys from an InfluxDB bucket

import "influxdata/influxdb/schema"

schema.fieldKeys(bucket: "example-bucket")