开始查询数据

1. 访问 localhost:8086

   在浏览器中登录并访问 InfluxDB UI。

2. 在左侧导航栏中，单击 数据浏览器。

3. InfluxDB 数据浏览器提供两个使用 Flux 查询数据的选项

   • 查询构建器（默认）：可视化查询构建器，可让您选择时间范围、测量、标签和要查询的字段。
   • 脚本编辑器：用于编写和运行 Flux 脚本的浏览器内代码编辑器。

   ---

   查询构建器

   要使用查询构建器构建和执行 Flux 查询:

   1. 在 FROM 列中，选择要查询的存储桶。对于本教程，选择 get-started 存储桶。

   2. 在下一个 filter 列中，从列下拉菜单中选择 _measurement，然后选择 home 测量。

   3. （可选）要查询特定字段或多个字段，请在下一个 filter 列中，从列下拉菜单中选择 _field，然后选择要查询的字段。在本教程中，有三个字段：co、hum 和 temp。

   4. （可选）要按特定标签值查询，请在下一个 filter 列中，从列下拉菜单中选择标签列，然后选择要按其过滤的标签值。在本教程中，标签列仅为 room。

   5. （可选）在 聚合函数 窗格中，选择一个聚合或选择器函数以用于对数据进行降采样。默认聚合函数为 mean。

   6. 在时间范围下拉菜单中，选择 自定义时间范围，然后从日期选择器中选择以下日期

      • 开始: 2022-01-01 08:00:00

      • 停止: 2022-01-01 20:00:01

        请注意，停止时间增加了一秒。在 Flux 中，停止时间是排他的，将排除具有该时间戳的点。通过增加一秒，查询将包括到 2022-01-01 20:00:00 的所有点.

   7. 单击 提交 以执行带有选定过滤器和操作的查询，并显示结果。

   ---

   脚本编辑器

   要使用查询构建器编写和执行 Flux 查询:

   1. 在数据浏览器中，单击 脚本编辑器。

   2. 在脚本编辑器文本字段中编写您的 Flux 查询。

      注意：您可以手动编写函数，也可以使用脚本编辑器右侧的函数列表来搜索和注入函数。

      1. 使用 from() 并使用 bucket 参数指定要查询的存储桶。对于本教程，查询 get-started 存储桶。

      2. 使用 range() 指定要查询的时间范围。start 参数定义结果中包含的最早时间。stop 参数指定结果中包含的最新时间（不包括在内）。

         • start：2022-01-01T08:00:00Z

         • stop：2022-01-01T20:00:01Z

           请注意，停止时间增加了一秒。在 Flux 中，停止时间是排他的，将排除具有该时间戳的点。通过增加一秒，查询将包括到 2022-01-01 20:00:00 的所有点.

         如果要使用在时间选择下拉菜单中选择的开始时间和停止时间，请使用 v.timeRangeStart 和 v.timeRangeStop 作为 start 和 stop 参数的值。

      3. 使用 filter() 按 home 测量过滤结果。

      4. （可选）使用 filter() 按特定字段过滤结果。在本教程中，有三个字段：co、hum 和 temp。

      5. （可选）使用 filter() 按特定标签值过滤结果。在本教程中，有一个标签 room，具有两个可能的值：Living Room 或 Kitchen。

      from(bucket: "get-started")
          |> range(start: 2022-01-01T08:00:00Z, stop: 2022-01-01T20:00:01Z)
          |> filter(fn: (r) => r._measurement == "home")
          |> filter(fn: (r) => r._field== "co" or r._field == "hum" or r._field == "temp")
      

   3. 单击 提交 以执行带有选定过滤器和操作的查询，并显示结果。

1. 如果尚未执行此操作，请下载、安装和配置 influx CLI。

2. 使用 influx query 命令使用 Flux 查询 InfluxDB。

   提供以下内容:

   • 字符串编码的 Flux 查询。
   • 连接和身份验证凭据

influx query '
from(bucket: "get-started")
    |> range(start: 2022-01-01T08:00:00Z, stop: 2022-01-01T20:00:01Z)
    |> filter(fn: (r) => r._measurement == "home")
    |> filter(fn: (r) => r._field== "co" or r._field == "hum" or r._field == "temp")
'

要使用 Flux 和 InfluxDB HTTP API 从 InfluxDB 查询数据，请使用 POST 请求方法向 InfluxDB API /api/v2/query 端点发送请求。

POST http://localhost:8086/api/v2/query

在您的请求中包含以下内容

• 标头:
  • Authorization：Token <INFLUX_TOKEN>
  • Content-Type：application/vnd.flux
  • Accept：application/csv
  • （可选）Accept-Encoding：gzip
• 查询参数:
  • org：InfluxDB 组织名称
• 请求正文：纯文本格式的 Flux 查询

以下示例使用 cURL 和 InfluxDB API 使用 Flux 查询数据

curl --request POST \
"$INFLUX_HOST/api/v2/query?org=$INFLUX_ORG&bucket=get-started" \
  --header "Authorization: Token $INFLUX_TOKEN" \
  --header "Content-Type: application/vnd.flux" \
  --header "Accept: application/csv" \
  --data 'from(bucket: "get-started")
    |> range(start: 2022-01-01T08:00:00Z, stop: 2022-01-01T20:00:01Z)
    |> filter(fn: (r) => r._measurement == "home")
    |> filter(fn: (r) => r._field== "co" or r._field == "hum" or r._field == "temp")
  '

1. 如果尚未执行此操作，请下载、安装和配置 influx CLI。

2. 使用 influx v1 shell 命令 启动 InfluxQL shell 并使用 InfluxQL 查询 InfluxDB。提供以下内容

   • 连接和身份验证凭据

   influx v1 shell
   

3. 输入 InfluxQL 查询并按 Enter ↵。

   SELECT co,hum,temp,room FROM "get-started".autogen.home WHERE time >= '2022-01-01T08:00:00Z' AND time <= '2022-01-01T20:00:00Z'
   

要使用 InfluxQL 和 InfluxDB HTTP API 从 InfluxDB 查询数据，请使用 POST 请求方法向 InfluxDB API /query 1.X 兼容性端点 发送请求。

POST http://localhost:8086/query

在您的请求中包含以下内容

• 标头:

  • Authorization：Token <INFLUX_TOKEN>
  • Accept: application/json
  • （可选）Accept-Encoding：gzip

• 查询参数:

  • db: 要查询的数据库。

  • rp: 从中查询数据的保留策略。

  • q: 要执行的 InfluxQL 查询。

  • epoch: （可选） 返回具有指定精度的 Unix 时间戳 而不是 RFC3339 时间戳 的结果。以下精度可用

    • ns - 纳秒
    • u 或 µ - 微秒
    • ms - 毫秒
    • s - 秒
    • m - 分钟
    • h - 小时

• 请求正文：纯文本格式的 Flux 查询

以下示例使用 cURL 和 InfluxDB API 通过 InfluxQL 查询数据

curl --get "$INFLUX_HOST/query?org=$INFLUX_ORG&bucket=get-started" \
  --header "Authorization: Token $INFLUX_TOKEN" \
  --data-urlencode "db=get-started" \
  --data-urlencode "rp=autogen" \
  --data-urlencode "q=SELECT co,hum,temp,room FROM home WHERE time >= '2022-01-01T08:00:00Z' AND time <= '2022-01-01T20:00:00Z'"