文档文档

influxdb.select() 函数

influxdb.select() 是由包作者维护的用户贡献函数。

influxdb.select()from()range()filter()pivot() 的替代实现,它返回透视的查询结果并屏蔽 _measurement_start_stop 列。结果类似于 InfluxQL SELECT 语句返回的结果。

函数类型签名
(
    from: string,
    m: A,
    start: B,
    ?fields: [string],
    ?host: string,
    ?org: string,
    ?stop: C,
    ?token: string,
    ?where: (
        r: {
            D with
            _value: E,
            _time: time,
            _stop: time,
            _start: time,
            _measurement: string,
            _field: string,
        },
    ) => bool,
) => stream[F] where A: Equatable, F: Record

有关更多信息,请参阅函数类型签名

参数

from

(必需) 要查询的存储桶的名称。

start

(必需) 结果中包含的最早时间。

结果包括与指定的开始时间匹配的点。使用相对持续时间、绝对时间或整数(Unix 时间戳,以秒为单位)。例如,-1h2019-08-28T22:00:00Z1567029600。持续时间相对于 now()

stop

结果中包含的最晚时间。默认为 now()

结果排除与指定的停止时间匹配的点。使用相对持续时间、绝对时间或整数(Unix 时间戳,以秒为单位)。例如,-1h2019-08-28T22:00:00Z1567029600。持续时间相对于 now()

m

(必需) 要查询的测量名称。

fields

要查询的字段列表。默认为 []

当列表为空或未指定时,返回所有字段。

where

单个参数谓词函数,评估结果为 truefalse,并根据标签值筛选结果。默认为 (r) => true

记录在字段透视到列之前传递给函数。评估结果为 true 的记录包含在输出表中。评估结果为false 的记录不包含在输出表中。

host

要查询的 InfluxDB 实例的 URL。

请参阅 InfluxDB OSS URLInfluxDB Cloud 区域

org

组织名称。

token

InfluxDB API 令牌

示例

查询单个字段

import "contrib/jsternberg/influxdb"

influxdb.select(from: "example-bucket", start: -1d, m: "example-measurement", fields: ["field1"])

查询多个字段

import "contrib/jsternberg/influxdb"

influxdb.select(
    from: "example-bucket",
    start: -1d,
    m: "example-measurement",
    fields: ["field1", "field2", "field3"],
)

查询所有字段并按标签筛选

import "contrib/jsternberg/influxdb"

influxdb.select(
    from: "example-bucket",
    start: -1d,
    m: "example-measurement",
    where: (r) => r.host == "host1" and r.region == "us-west",
)

从远程 InfluxDB Cloud 实例查询数据

import "contrib/jsternberg/influxdb"
import "influxdata/influxdb/secrets"

token = secrets.get(key: "INFLUXDB_CLOUD_TOKEN")

influxdb.select(
    from: "example-bucket",
    start: -1d,
    m: "example-measurement",
    fields: ["field1", "field2"],
    host: "https://us-west-2-1.aws.cloud2.influxdata.com",
    org: "example-org",
    token: token,
)

此页是否对您有帮助?

感谢您的反馈!


Flux 的未来

Flux 即将进入维护模式。您可以继续像目前一样使用它,而无需对代码进行任何更改。

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

快速启动。更快扩展。

获取更新

InfluxDB 3 Core 是一个开源、高速、最近数据引擎,可实时收集和处理数据,并将其持久化到本地磁盘或对象存储。InfluxDB 3 Enterprise 以 Core 的基础为构建基础,增加了高可用性、读取副本、增强的安全性以及数据压缩,以实现更快的查询和优化的存储。InfluxDB 3 Enterprise 的免费层可供非商业家庭或业余爱好者使用。

有关更多信息,请查看