influxctl write
influxctl write 命令将 Line Protocol 写入 InfluxDB Clustered。
通过以下方式之一提供 Line Protocol
- 命令行上的字符串
- 包含 Line Protocol 的文件路径
- 单个破折号 (
-) 从 stdin 读取 Line Protocol
重要提示
- 此命令每次执行仅支持一个写入请求，但支持多行 Line Protocol，并将根据
--batch-size批量处理数据。 - 此命令并非旨在成为功能齐全的写入工具。它旨在用于调试、问题分类和初始探索。
InfluxDB 连接配置
您的 InfluxDB 集群主机和端口在您的 influxctl 连接配置文件中配置。默认使用 TLS 和端口 443。您可以在连接配置文件中设置用于 query 和 write 命令的默认数据库和令牌，或者使用 --database 和 --token 标志通过命令传递它们。命令行标志会覆盖连接配置文件中的设置。
用法
influxctl write [flags] <LINE_PROTOCOL>
参数
| 参数 | 描述 |
|---|---|
| LINE_PROTOCOL | 要写入的 Line Protocol（命令行字符串、文件路径或 - 从 stdin 读取） |
标志
| 标志 | 描述 | |
|---|---|---|
--batch-size | 每个批次写入的指标数量（默认为 10000） | |
--database | 要写入的数据库 | |
--precision | 数据时间戳的精度 (ns (默认), us, ms, 或 s) | |
--timeout | 客户端超时时间（秒）（默认为 10） | |
--token | 对目标数据库具有写入权限的数据库令牌 | |
-h | --help | 输出命令帮助 |
另请参阅 influxctl 全局标志。
示例
- 将 Line Protocol 写入 InfluxDB 3
- 将 Line Protocol 写入 InfluxDB 3，使用非默认时间戳精度
- 将 Line Protocol 写入 InfluxDB 3，使用自定义批次大小
- 将 Line Protocol 写入 InfluxDB 3，使用自定义客户端超时时间
- 使用连接配置文件中的凭据将 Line Protocol 写入 InfluxDB 3
在以下示例中，替换以下内容
DATABASE_TOKEN: 具有对目标数据库写入访问权限的数据库令牌DATABASE_NAME: 要写入的数据库的名称
将 Line Protocol 写入 InfluxDB 3
influxctl write \
--token DATABASE_TOKEN \
--database DATABASE_NAME \
/path/to/metrics.lp
cat ./metrics.lp | influxctl write \
--token DATABASE_TOKEN \
--database DATABASE_NAME \
-
将 Line Protocol 写入 InfluxDB 3，使用非默认时间戳精度
influxctl write \
--token DATABASE_TOKEN \
--database DATABASE_NAME \
--precision s \
/path/to/metrics.lp
cat ./metrics.lp | influxctl write \
--token DATABASE_TOKEN \
--database DATABASE_NAME \
--precision s \
-
将 Line Protocol 写入 InfluxDB 3，使用自定义批次大小
influxctl write \
--token DATABASE_TOKEN \
--database DATABASE_NAME \
--batch-size 5000 \
/path/to/metrics.lp
cat ./metrics.lp | influxctl write \
--token DATABASE_TOKEN \
--database DATABASE_NAME \
--batch-size 5000 \
-
将 Line Protocol 写入 InfluxDB 3，使用自定义客户端超时时间
influxctl write \
--token DATABASE_TOKEN \
--database DATABASE_NAME \
--timeout 20 \
/path/to/metrics.lp
cat ./metrics.lp | influxctl write \
--token DATABASE_TOKEN \
--database DATABASE_NAME \
--timeout 20 \
-
使用连接配置文件中的凭据将 Line Protocol 写入 InfluxDB 3
以下示例使用 default 连接配置文件中定义的 database 和 token。
此页是否对您有帮助？
感谢您的反馈！
支持和反馈
感谢您成为我们社区的一份子！我们欢迎并鼓励您对 InfluxDB Clustered 和本文档提供反馈和错误报告。要寻求支持，请使用以下资源
拥有年度或支持合同的客户可以联系 InfluxData 支持。