使用 InfluxDB API 查询数据

InfluxDB API是查询InfluxDB中数据的主要方式（请参见命令行界面和客户端库以获取查询数据库的替代方法）。

使用 Flux 或 InfluxQL 通过 InfluxDB API 查询数据。

注意: 以下示例使用 curl，一个通过 URLs 传输数据的命令行工具。了解 curl 的基础知识请参考 HTTP 脚本指南。

使用Flux查询数据

对于Flux查询，/api/v2/query端点接受POST HTTP请求。使用以下HTTP头：

• Accept: application/csv
• Content-type: application/vnd.flux

如果您启用了身份验证，请通过 Authorization 头和 Token 模式提供您的 InfluxDB 用户名和密码。 例如： Authorization: Token username:password。

以下示例使用Flux查询Telegraf数据：

$ curl -XPOST localhost:8086/api/v2/query -sS \
  -H 'Accept:application/csv' \
  -H 'Content-type:application/vnd.flux' \
  -d 'from(bucket:"telegraf")
        |> range(start:-5m)
        |> filter(fn:(r) => r._measurement == "cpu")'  

Flux 返回 带注释的 CSV:

{,result,table,_start,_stop,_time,_value,_field,_measurement,cpu,host
,_result,0,2020-04-07T18:02:54.924273Z,2020-04-07T19:02:54.924273Z,2020-04-07T18:08:19Z,4.152553004641827,usage_user,cpu,cpu-total,host1
,_result,0,2020-04-07T18:02:54.924273Z,2020-04-07T19:02:54.924273Z,2020-04-07T18:08:29Z,7.608695652173913,usage_user,cpu,cpu-total,host1
,_result,0,2020-04-07T18:02:54.924273Z,2020-04-07T19:02:54.924273Z,2020-04-07T18:08:39Z,2.9363988504310883,usage_user,cpu,cpu-total,host1
,_result,0,2020-04-07T18:02:54.924273Z,2020-04-07T19:02:54.924273Z,2020-04-07T18:08:49Z,6.915093159934975,usage_user,cpu,cpu-total,host1}

标题行定义了表格的列标签。cpu measurement 有四个点，每个点由一条记录行表示。例如，第一个点的timestamp是2020-04-07T18:08:19。

通量

查看使用Flux入门以了解更多关于使用Flux构建查询的信息。有关使用Flux通过InfluxDB API查询数据的更多信息，请参见API参考文档。

使用InfluxQL查询数据

要执行 InfluxQL 查询，发送一个 GET 请求到 /query 端点，将 URL 参数 db 设置为目标数据库，并将 URL 参数 q 设置为您的查询。您也可以通过发送相同的参数作为 URL 参数或作为带有 application/x-www-form-urlencoded 的请求体的一部分来使用 POST 请求。下面的示例使用 InfluxDB API 查询您在 Writing Data 中遇到的相同数据库。

curl -G 'http://localhost:8086/query?pretty=true' --data-urlencode "db=mydb" --data-urlencode "q=SELECT \"value\" FROM \"cpu_load_short\" WHERE \"region\"='us-west'"

InfluxDB 返回 JSON：

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "name": "cpu_load_short",
                    "columns": [
                        "time",
                        "value"
                    ],
                    "values": [
                        [
                            "2015-01-29T21:55:43.702900257Z",
                            2
                        ],
                        [
                            "2015-01-29T21:55:43.702900257Z",
                            0.55
                        ],
                        [
                            "2015-06-11T20:46:02Z",
                            0.64
                        ]
                    ]
                }
            ]
        }
    ]
}

注意： 将 pretty=true 附加到 URL 可以启用美化的 JSON 输出。虽然这在调试时或者使用像 curl 这样的工具直接查询时很有用，但不建议在生产环境中使用，因为它会消耗不必要的网络带宽。

InfluxQL

查看数据探索页面以了解InfluxQL。有关使用InfluxQL通过InfluxDB API 查询数据的更多信息，请参阅API参考文档。