Documentation

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

使用 InfluxDB v1 HTTP 查询 API 通过 InfluxQL 查询 InfluxDB 集群中的数据。

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

InfluxQL特性支持

InfluxQL 正在重新架构以与 InfluxDB 3 存储引擎配合使用。 这个过程仍在进行中,一些 InfluxQL 功能仍在实施中。 有关 InfluxQL 功能当前实施状态的信息, 请参见 InfluxQL feature support

使用 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交互,请提供以下凭据:

  • username: 一个任意字符串 (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 返回,请包含 Accept 头,并使用 application/csvtext/csv MIME 类型:

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 3 开源版本现已公开Alpha测试

InfluxDB 3 Open Source is now available for alpha testing, licensed under MIT or Apache 2 licensing.

我们将发布两个产品作为测试版的一部分。

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

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