文档

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

使用InfluxDB v1 HTTP查询API和InfluxQL查询InfluxDB Clustered中的数据。

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

InfluxQL特性支持

InfluxQL正在重新设计以与InfluxDB v3存储引擎一起工作。此过程正在进行中,一些InfluxQL功能仍在实现中。有关InfluxQL功能的当前实现状态的信息,请参阅InfluxQL特性支持

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

GET https://cluster-host.com/query

请提供以下内容作为您的请求

  • 头部
    • 授权: Bearer DATABASE_TOKEN
  • 查询参数
    • db: 要查询的数据库名称
    • rp: 可选:要查询的保留策略
    • q: URL编码的InfluxQL查询
curl --get https://cluster-host.com/query \
  --header "Authorization: Bearer 
DATABASE_TOKEN
"
\
--data-urlencode "db=
DATABASE_NAME
"
\
--data-urlencode "q=SELECT * FROM home"

替换以下配置值

  • DATABASE_NAME: 要查询的数据库名称。
  • DATABASE_TOKEN: 具有指定数据库读取访问权限的数据库令牌

使用用户名和密码进行身份验证

如果您使用基本身份验证或查询字符串身份验证(用户名和密码)与v1 HTTP查询API交互,请提供以下凭据

  • 用户名: 一个任意字符串(InfluxDB Clustered忽略用户名)
  • 密码: 具有指定数据库读取访问权限的数据库令牌
curl --get https://cluster-host.com/query \
  --header "Authorization: Basic ignored:
DATABASE_TOKEN
"
\
--data-urlencode "db=
DATABASE_NAME
"
\
--data-urlencode "q=SELECT * FROM home"
curl --get https://cluster-host.com/query \
  --data-urlencode "u=ignored" \
  --data-urlencode "p=
DATABASE_TOKEN
"
\
--data-urlencode "db=
DATABASE_NAME
"
\
--data-urlencode "q=SELECT * FROM home"

将结果返回为JSON或CSV

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

curl --get https://cluster-host.com/query \
  --header "Authorization: Token 
DATABASE_TOKEN
"
\
--header "Accept: application/csv" \ --data-urlencode "db=
DATABASE_NAME
"
\
--data-urlencode "q=SELECT * FROM home"

这个页面有帮助吗?

感谢您的反馈!


Flux的未来

Flux将进入维护模式。您无需对代码进行任何更改,可以继续按当前方式使用它。

了解更多

InfluxDB v3增强功能和InfluxDB集群现在已全面上市

新功能包括更快的查询性能和管理工具,推动InfluxDB v3产品线的进步。InfluxDB集群现在已全面上市。

InfluxDB v3性能和功能

InfluxDB v3产品线在查询性能方面取得了显著提升,并提供了新的管理工具。这些增强包括用于监控InfluxDB集群健康状况的操作仪表板、InfluxDB云专用中的单点登录(SSO)支持和用于令牌和数据库的新管理API。

了解新的v3增强功能


InfluxDB集群全面上市

InfluxDB集群现在已全面上市,为您的自管理堆栈提供InfluxDB v3的强大功能。

与我们讨论InfluxDB集群