文档文档

influx - InfluxDB 命令行界面

influx 命令行界面 (CLI) 包含用于管理 InfluxDB 许多方面的命令,包括存储桶、组织、用户、任务等。

InfluxDB OSS 和 influx CLI 版本

InfluxDB 2.1 开始,influx CLI 与 InfluxDB 分开打包和版本化。 InfluxDB 和 influx CLI 版本可能不同,但每个命令都注明了兼容性。

下载并安装 influx CLI

执行以下操作之一

使用 Homebrew

brew install influxdb-cli

如果您使用 Homebrew 安装 InfluxDB 2.7,则 influxdb-cli 公式已作为依赖项下载,并且应该已经安装。 如果已安装,influxdb-cli 将出现在以下命令的输出中

brew list | grep influxdb-cli

手动下载并安装

  1. 下载 influx CLI 包。

    influx CLI v2.7.5 (macOS)

  2. 解包下载的软件包。

    执行以下操作之一

    • Finder 中双击下载的软件包文件。

    • 在 macOS 命令提示符应用程序(例如 终端iTerm2)中运行以下命令

      # Unpackage contents to the current working directory
      tar zxvf ~/Downloads/influxdb2-client-2.7.5-darwin-amd64.tar.gz
      
  3. (可选) 将二进制文件放在您的 $PATH 中。

    # (Optional) Copy the influx binary to your $PATH
    sudo cp ~/Downloads/influxdb2-client-2.7.5-darwin-amd64/influx /usr/local/bin/
    

    如果您不将 influx 二进制文件移动到您的 $PATH 中,请在可执行文件 ./ 前面加上前缀以就地运行它。

  4. (macOS Catalina 及更高版本) 授权 influx 二进制文件。

    macOS 要求下载的二进制文件由注册的 Apple 开发人员签名。 当您第一次尝试运行 influx 时,macOS 将阻止它运行。 要授权 influx 二进制文件

    1. 尝试运行 influx 命令。
    2. 打开 系统偏好设置 并单击 安全性与隐私
    3. 通用 选项卡下,有一条关于 influx 被阻止的消息。 单击 仍然打开
  1. 下载 influx CLI 包。

    浏览器下载从命令行下载 influx CLI 包。

    从浏览器下载

    influx CLI v2.7.5 (amd64) influx CLI v2.7.5 (arm)

    从命令行下载

    # amd64
    wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-linux-amd64.tar.gz
    
    # arm
    wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-linux-arm64.tar.gz
    
  2. 解包下载的软件包。

    注意:以下命令是示例。 如果需要,调整文件名、路径和实用程序。

    # amd64
    tar xvzf path/to/influxdb2-client-2.7.5-linux-amd64.tar.gz
    
    # arm
    tar xvzf path/to/influxdb2-client-2.7.5-linux-arm64.tar.gz
    
  3. (可选) 将解包的 influx 可执行文件放在您的系统 $PATH 中。

    # amd64
    sudo cp influxdb2-client-2.7.5-linux-amd64/influx /usr/local/bin/
    
    # arm
    sudo cp influxdb2-client-2.7.5-linux-arm64/influx /usr/local/bin/
    

    如果您不将 influx 二进制文件移动到您的 $PATH 中,请在可执行文件 ./ 前面加上前缀以就地运行它。

我们建议在 Powershell 中运行 influx CLI 命令。 命令提示符未完全兼容。

  1. 下载 influx CLI 包。

    influx CLI v2.7.5 (Windows)

  2. 展开下载的存档。

    将下载的存档展开到 C:\Program Files\InfluxData\ 中,并根据需要重命名它。

    > Expand-Archive .\influxdb2-client-2.7.5-windows-amd64.zip -DestinationPath 'C:\Program Files\InfluxData\'
    > mv 'C:\Program Files\InfluxData\influxdb2-client-2.7.5-windows-amd64' 'C:\Program Files\InfluxData\influx'
    
  3. 授予 influx CLI 网络访问权限。

    首次使用 influx CLI 时,Windows Defender 会显示以下消息

    Windows Defender 防火墙阻止了此应用程序的某些功能。

    要授予 influx CLI 所需的访问权限,请执行以下操作

    1. 选择 专用网络,例如我的家庭或工作网络
    2. 单击 允许访问

提供所需的身份验证凭据

为了避免每次命令都传递 InfluxDB 主机API 令牌组织,请将它们存储在 influx CLI 配置(config)中。 需要这些凭据的 influx 命令会自动从活动配置中检索这些凭据。

使用 influx config create 命令 创建 influx CLI 配置并将其设置为活动状态

influx config create --config-name <config-name> \
  --host-url https://127.0.0.1:8086 \
  --org <your-org> \
  --token <your-auth-token> \
  --active

有关管理 CLI 配置的更多信息,请参阅 influx config 文档

凭据优先级

有三种方法可以为 influx CLI 提供必要的凭据,它在检索凭据时使用以下优先级

  1. 命令行标志 (--host, --org -o, --token -t)
  2. 环境变量 (INFLUX_HOST, INFLUX_ORG, INFLUX_TOKEN)
  3. CLI 配置文件

用法

influx [flags]
influx [command]

命令

命令描述
apply应用 InfluxDB 模板
authAPI 令牌管理命令
backup备份数据(仅限 InfluxDB OSS)
bucket存储桶管理命令
bucket-schema管理 InfluxDB 存储桶架构(仅限 InfluxDB Cloud)
completion生成完成脚本
config配置管理命令
dashboards列出仪表板
delete从 InfluxDB 中删除点
export将资源导出为模板
help关于任何命令的帮助
org组织管理命令
ping检查 InfluxDB /health 端点
query执行 Flux 查询
restore恢复备份数据(仅限 InfluxDB OSS)
scripts脚本管理命令(仅限 InfluxDB Cloud)
secret管理密钥
setup创建默认用户名、密码、组织、存储桶等(仅限 InfluxDB OSS)
stacks管理 InfluxDB 堆栈
task任务管理命令
telegrafsTelegraf 配置管理命令
template总结并验证 InfluxDB 模板
user用户管理命令
v1使用 v1 兼容性 API
version打印 influx CLI 版本
write将数据点写入 InfluxDB

标志

Flag (标志)描述
-h--helpinflux 命令的帮助信息

标志模式和约定

influx CLI 使用以下模式和约定

映射的环境变量

映射到环境变量的 influx CLI 标志在每个命令文档的标志表的 Mapped to (映射到) 列中列出。映射的标志继承环境变量的值。要覆盖环境变量,请在命令中显式设置该标志。

查看映射的环境变量

速记和冗长标志

许多 influx CLI 标志都支持简写和完整形式。

  • shorthand (简写): 简写标志以单个连字符开头,后跟单个字母(例如:-c)。
  • longhand (完整形式): 完整形式的标志以两个连字符开头,后跟一个多字母、连字符分隔的标志名称(例如:--active-config)。

命令可以在单个执行中使用简写和完整形式的标志。

标志输入类型

influx CLI 标志输入类型在每个命令的标志表中列出。标志支持以下输入类型

字符串

文本字符串,但每个命令执行只能使用一次该标志。

stringArray

单个文本字符串,但每个命令执行可以多次使用该标志。

整数

表示整数值的数字序列。

持续时间

由整数和持续时间单位表示的时间长度(1ns1us1µs1ms1s1m1h1d1w)。


此页面是否对您有所帮助?

感谢您的反馈!


Flux 的未来

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

了解更多

InfluxDB 3 开源现在处于公开 Alpha 阶段

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

我们正在发布两种产品作为 alpha 的一部分。

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

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