docs-v2/content/flux/v0/stdlib/experimental/query/fromrange.md

2.3 KiB

title description menu weight flux/v0/tags
query.fromRange() function `query.fromRange()` returns all data from a specified bucket within given time bounds.
flux_v0_ref
name parent identifier
query.fromRange experimental/query experimental/query/fromRange
201
transformations
filters

query.fromRange() returns all data from a specified bucket within given time bounds.

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

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

Parameters

bucket

({{< req >}}) InfluxDB bucket name.

start

({{< req >}}) Earliest time to include in results.

Results include points that match the specified start time. Use a relative duration, absolute time, or integer (Unix timestamp in seconds). For example, -1h, 2019-08-28T22:00:00Z, or 1567029600. Durations are relative to now().

stop

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

Results exclude points that match the specified stop time. Use a relative duration, absolute time, or integer (Unix timestamp in seconds).For example, -1h, 2019-08-28T22:00:00Z, or 1567029600. Durations are relative to now().

Examples

Query data from InfluxDB in a specified time range

import "experimental/query"

query.fromRange(bucket: "example-bucket", start: -1h)