文档文档

使用 InfluxDB v1 HTTP 查询 API 和 InfluxQL 查询数据

使用 InfluxDB v1 HTTP 查询 API,通过 InfluxQL 在 InfluxDB 3 Core 中查询数据。

以下示例使用 cURL 向 InfluxDB v1 HTTP API 发送 HTTP 请求,但你可以使用任何 HTTP 客户端。

InfluxQL 功能支持

InfluxQL 正在被重新架构,以与 InfluxDB 3 存储引擎协同工作。此过程正在进行中,某些 InfluxQL 功能仍在实施中。有关 InfluxQL 功能当前实施状态的信息,请参阅 InfluxQL 功能支持

使用 v1 /query 端点和 GET 请求方法,通过 InfluxQL 查询数据

GET http://localhost:8181/query

在请求中提供以下内容

  • 标头

    • Authorization: Bearer AUTH_TOKEN

      在 Beta 测试期间,InfluxDB 3 Core 不需要授权令牌。你可以省略此标头,或包含带有任意令牌字符串的标头。

  • 查询参数

    • db: 要查询的数据库
    • rp: 可选:要查询的保留策略
    • q: URL 编码的 InfluxQL 查询
curl --get https://localhost:8181/query \
  --header "Authorization: Bearer 
AUTH_TOKEN
"
\
--data-urlencode "db=
DATABASE_NAME
"
\
--data-urlencode "q=SELECT * FROM home"

替换以下配置值

  • DATABASE_NAME: 要查询的数据库名称
  • AUTH_TOKEN: 你的授权令牌

以 JSON 或 CSV 格式返回结果

默认情况下,/query 端点以 JSON 格式返回结果,但它也可以以 CSV 格式返回结果。要以 CSV 格式返回结果,请包含带有 application/csvtext/csv MIME 类型的 Accept 标头

curl --get https://localhost:8181/query \
  --header "Authorization: BEARER 
AUTH_TOKEN
"
\
--header "Accept: application/csv" \ --data-urlencode "db=
DATABASE_NAME
"
\
--data-urlencode "q=SELECT * FROM home"

此页内容是否对您有帮助?

感谢您的反馈!


Flux 的未来

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

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

快速启动。更快扩展。

获取更新

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

有关更多信息,请查看