开始查询数据

1. 访问 cloud2.influxdata.com 在浏览器中登录并访问 InfluxDB 用户界面。

2. 在左侧导航栏中，点击 数据探测器。

3. InfluxDB 数据探测器提供了两种使用 Flux 查询数据的选项：

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

   ---

   查询构建器

   使用查询构建器构建并执行Flux查询:

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

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

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

   4. (可选) 要通过特定标签值进行查询，在下一个 过滤器 列中，从下拉菜单中选择标签列，然后选择要过滤的标签值。在本教程中，唯一的标签列是 房间。

   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 参数指定了结果中包括的最晚时间（不包括）。

         • 开始: 2022-01-01T08:00:00Z

         • 停止: 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，其潜在值为： 客厅 或 厨房。

      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查询数据，请向InfluxDB API /api/v2/query端点发送请求，使用POST请求方法。

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

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

• 头部:
  • 授权: 令牌 <INFLUX_TOKEN>
  • 内容类型: application/vnd.flux
  • 接受: application/csv
  • (可选) 接受编码: 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 查询数据，请发送请求 到 InfluxDB API /query 1.X 兼容终端 使用 POST 请求方法。

POST http://localhost:8086/query

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

• 标题:

  • Authorization: Token <INFLUX_TOKEN>
  • Accept: application/json
  • (Optional) Accept-Encoding: gzip

• 查询参数:

  • db: 要查询的数据库。

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

  • q: 要执行的InfluxQL查询。

  • epoch: (可选) 返回具有指定精度的 Unix 时间戳，而不是RFC3339 时间戳。以下精度可用：

    • ns - nanoseconds
    • u or µ - microseconds
    • ms - milliseconds
    • s - seconds
    • m - minutes
    • h - hours

• 请求体: 作为纯文本的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'"