安装和使用 influx CLI
使用 influx
CLI 与您的 InfluxDB 实例交互和管理。写入和查询数据、生成 InfluxDB 模板、导出数据等等。
influx
CLI 与 InfluxDB 服务器 (influxd
) 分开打包和版本控制。
安装 influx CLI
执行以下操作之一
使用 Homebrew
brew install influxdb-cli
如果您使用 Homebrew 安装了 InfluxDB 2.7,则 influxdb-cli
公式已作为依赖项下载,并且应该已经安装。如果已安装,influxdb-cli
将出现在以下命令的输出中
brew list | grep influxdb-cli
手动下载和安装
从您的浏览器下载
从命令行下载
curl -LO https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-darwin-amd64.tar.gz \ --output-dir ~/Downloads
解包下载的二进制文件。
执行以下操作之一
在 Finder 中,双击下载的包文件。
在您的终端(例如,终端或 iTerm2)中使用
tar
解压包 - 例如,输入以下命令将其解压到~/Downloads
tar zxvf ~/Downloads/influxdb2-client-2.7.5-darwin-amd64.tar.gz \ --directory ~/Downloads
可选:将
influx
二进制文件放在您的$PATH
中 - 例如,将二进制文件复制到/usr/local/bin
sudo cp ~/Downloads/influx /usr/local/bin/
将
influx
二进制文件放在您的$PATH
(/usr/local/bin
) 中后,您可以在终端中输入influx
来运行 CLI。如果您不将
influx
二进制文件移动到您的$PATH
中,请输入二进制文件的路径以运行 CLI - 例如~/Downloads/influx
(macOS Catalina 和更高版本)授权
influx
二进制文件。macOS 要求下载的二进制文件由注册的 Apple 开发者签名。当您首次尝试运行
influx
时,macOS 会阻止它运行。要授权influx
二进制文件在 macOS Ventura 上允许二进制文件
- 按照前面的说明尝试启动
influx
。 - 打开系统设置,然后单击隐私与安全性。
- 在安全性标题下,有一条关于“influxd”被阻止的消息,单击仍然允许。
- 出现提示时,输入您的密码以允许该设置。
- 关闭系统设置。
- 尝试启动
influx
。 - 将出现一个提示,其中包含消息“macOS 无法验证“influx”的开发者…”。单击打开。
在 macOS Catalina 上允许二进制文件
- 尝试运行
influx
命令。 - 打开系统偏好设置,然后单击安全性与隐私。
- 在通用选项卡下,有一条关于
influx
被阻止的消息。单击仍然打开。
- 按照前面的说明尝试启动
从您的浏览器下载
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
解包下载的二进制文件。
注意:以下命令是示例。如有必要,调整文件名、路径和实用程序。
# amd64 tar xvzf ./influxdb2-client-2.7.5-linux-amd64.tar.gz
# arm tar xvzf ./influxdb2-client-2.7.5-linux-arm64.tar.gz
可选:将解压后的
influx
可执行文件放在您的系统$PATH
中。# amd64 sudo cp ./influx /usr/local/bin/
# arm sudo cp ./influx /usr/local/bin/
如果您不将
influxd
二进制文件移动到您的$PATH
中,请输入二进制文件的路径以启动服务器 - 例如./influx
我们建议在 Powershell 中运行 influx
CLI 命令。命令提示符不完全兼容。
下载
influx
CLI 包。展开下载的存档。
将下载的存档展开到
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'
授予
influx
CLI 网络访问权限。首次使用
influx
CLI 时,Windows Defender 会显示以下消息Windows Defender 防火墙阻止了此应用的某些功能。
要授予
influx
CLI 所需的访问权限,请执行以下操作- 选择专用网络,例如我的家庭或工作网络。
- 单击允许访问。
设置 influx CLI
提供所需的身份验证凭据
为了避免每次命令都传递 InfluxDB 主机、API 令牌和组织,请将它们存储在 influx
CLI 配置(config)中。需要这些凭据的 influx
命令会自动从活动配置中检索这些凭据。
使用 influx config create
命令 创建 influx
CLI 配置并将其设置为活动配置
influx config create --config-name CONFIG_NAME \
--host-url http://localhost:8086 \
--org ORG \
--token API_TOKEN \
--active
替换以下内容
有关管理 CLI 配置的更多信息,请参阅 influx config
文档。
有关如何创建 API 令牌的说明,请参阅 创建令牌。
使用用户名和密码进行身份验证
influx
CLI 2.4.0+ 允许您创建连接配置,该配置使用您用于登录 InfluxDB 用户界面 (UI) 的用户名和密码组合来验证 InfluxDB OSS 2.4+ 的身份。CLI 检索会话 cookie 并将其未加密地存储在您的 configs 路径中。
使用 --username-password
, -p
选项使用 <username>:<password>
语法提供您的用户名和密码。如果未提供密码,则 CLI 会在每次需要身份验证的命令后提示输入密码。
influx config create \
-n CONFIG_NAME \
-u http://localhost:8086 \
-p USERNAME:PASSWORD \
-o ORG
替换以下内容
CONFIG_NAME
:连接配置名称。ORG
: 您的组织名称。USERNAME:PASSWORD
: 您的 UI 用户名和密码组合。
启用 shell 补全(可选)
要安装 influx
shell 补全脚本,请参阅 influx completion
。
使用 influx CLI 命令
有关 influx
CLI 命令的信息,请参阅 influx
CLI 参考文档。
此页面是否有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一份子!我们欢迎并鼓励您提供关于 InfluxDB 和本文档的反馈和错误报告。要寻求支持,请使用以下资源
拥有年度合同或支持合同的客户可以联系 InfluxData 支持。