文档文档

测试你的 InfluxDB 集群

在你的 InfluxDB 集群已部署并运行后,进行测试以确保你可以成功地从 InfluxDB 写入和查询数据。

  1. 下载并安装 influxctl
  2. 检索你的集群的管理员令牌
  3. 配置 influxctl 以连接到你的集群
  4. 创建一个新数据库
  5. 将测试数据写入新数据库
  6. 从你的数据库查询测试数据

下载并安装 influxctl

influxctl 是一个命令行工具,允许你从本地计算机管理你的 InfluxDB 集群,并向其写入和查询数据。

下载并安装 influxctl

检索你的集群的管理员令牌

InfluxDB 集群版生成一个有效的访问令牌(称为管理员令牌),并将其作为密钥存储在你集群的 influxdb 命名空间中。在安装过程的此阶段,使用管理员令牌与 influxctl,而不是配置和使用身份提供商。

使用 kubectl 从你的 influxdb 命名空间密钥存储中检索管理员令牌,并将其复制到一个文件

kubectl get secrets/admin-token \
  --template={{.data.token}} \
  --namespace influxdb | base64 -d > token.json

配置 influxctl 以连接到你的集群

为你的 InfluxDB 集群创建一个 influxctl 连接配置文件。连接配置文件存储在你本地计算机上的 config.toml 文件中,包含连接和授权 InfluxDB 集群所需的凭据。

  1. 创建一个名为 config.toml 的文件,内容如下

    [[profile]]
      name = "default"
      product = "clustered"
      host = "cluster-host.com"
      port = "
    INFLUXDB_PORT
    "
    [profile.auth.token] token_file = "/
    DIRECTORY_PATH
    /token.json"

    在上面的示例中,替换以下内容

    • INFLUXDB_PORT: 用于连接到你的 InfluxDB 集群的端口。
    • DIRECTORY_PATH: 你的管理员令牌文件 token.json 的目录路径。

    要设置你的 InfluxDB 集群主机,请点击上面代码块下方的 ** Set InfluxDB cluster URL**,并提供你的集群主机。 这将更新所有代码示例中你的集群主机。

  2. 通过以下方式之一使此配置文件可用于 influxctl

    • 在所有 influxctl 命令中包含 --config 标志,以指定你的 config.toml 文件的文件路径。
    • config.toml 文件存储在 默认位置influxctl 期望根据你的操作系统查找连接配置文件。 如果你的连接配置文件位于默认位置,则无需在 influxctl 命令中包含 --config 标志。

连接配置示例

在以下示例中,将 CONFIG_PATH 替换为你的连接配置文件的目录路径。 如果你将配置文件放置在操作系统的默认位置,请在运行示例命令之前从示例命令中删除 --config /CONFIG_PATH/config.toml

创建一个新数据库

使用 influxctl database create 创建一个名为 testdb 的新数据库。 包括以下内容

  • (可选) 你的连接配置文件路径。
  • 数据库名称 – testdb
influxctl --config /
CONFIG_PATH
/config.toml database create testdb

将测试数据写入新数据库

使用 influxctl write 将以下测试数据写入你的 testdb 数据库。 提供以下内容

  • (可选) 你的连接配置文件路径。
  • 数据库名称 – testdb
  • Line Protocol 用于写入 InfluxDB。
influxctl --config /
CONFIG_PATH
/config.toml write \
--database testdb \ "home,room=Living\ Room temp=21.1,hum=35.9,co=0i 1641024000000000000 home,room=Kitchen temp=21.0,hum=35.9,co=0i 1641024000000000000 home,room=Living\ Room temp=21.4,hum=35.9,co=0i 1641027600000000000 home,room=Kitchen temp=23.0,hum=36.2,co=0i 1641027600000000000 "

从你的数据库查询测试数据

使用 influxctl query 从你的 testdb 数据库查询测试数据。 提供以下内容

  • (可选) 你的连接配置文件路径。
  • 数据库名称 – testdb
  • 要执行的 SQL 查询。
influxctl --config /
CONFIG_PATH
/config.toml query \
--database testdb \ "SELECT * FROM home"

这应该返回类似于以下的结果

cohumroomtemptime
035.9Living Room21.12022-01-01T08:00:00Z
035.9Kitchen212022-01-01T08:00:00Z
021.4Living Room21.42022-01-01T09:00:00Z
036.2Kitchen232022-01-01T09:00:00Z

如果查询成功返回数据,则你的 InfluxDB 集群已设置并正常运行。


此页面是否对您有帮助?

感谢您的反馈!


Flux 的未来

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

阅读更多

InfluxDB 3 开源版现已公开发布 Alpha 版本

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

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

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

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