文档文档

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

InfluxDB 3 Core 处于公开 Alpha 阶段

InfluxDB 3 Core 处于公开 Alpha 阶段,可用于测试和反馈,但不适用于生产环境。产品和本文档均在开发中。我们欢迎并鼓励您提供关于 Alpha 体验的意见,并邀请您加入我们的公开频道以获取更新和分享反馈。

Alpha 预期和建议

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

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

InfluxQL 功能支持

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

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

GET https://#:8181/query

在您的请求中提供以下内容

  • 标头

    • Authorization: Bearer AUTH_TOKEN

      在 Alpha 阶段,InfluxDB 3 Core 不需要授权令牌。您可以省略此标头,或者包含带有任意令牌字符串的标头。

  • 查询参数

    • db: 要查询的数据库
    • rp: 可选:要查询的保留策略
    • q: URL 编码的 InfluxQL 查询
curl --get https://#: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://#: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 开源版本现已发布公开 Alpha 版

InfluxDB 3 开源版本现已可用于 Alpha 测试,根据 MIT 或 Apache 2 许可获得许可。

我们正在发布两个产品作为 Alpha 版的一部分。

InfluxDB 3 Core 是我们的新开源产品。它是用于时间序列和事件数据的最新数据引擎。InfluxDB 3 Enterprise 是一个商业版本,它建立在 Core 的基础上,增加了历史查询能力、读取副本、高可用性、可扩展性和细粒度的安全性。

有关如何开始使用的更多信息,请查看