使用 influxdb3 CLI 写入数据
使用 influxdb3
CLI 将行协议数据写入 InfluxDB 3 Core。
使用 API 进行批量和更高容量的写入
influxdb3
CLI 让您可以快速开始将数据写入 InfluxDB 3 Core。 对于批量和更高容量的写入工作负载,请使用 API 客户端库 或 Telegraf。
构建行协议
通过 对行协议的基本理解,您可以构建行协议格式的数据并将其写入 InfluxDB 3 Core。 考虑一个您从家中的传感器收集数据的用例。 每个传感器收集温度、湿度和一氧化碳读数。 要收集此数据,请使用以下模式
- 表:
home
- 标签
room
: 客厅或厨房
- 字段
temp
: 温度,单位 °C (浮点数)hum
: 湿度百分比 (浮点数)co
: 一氧化碳,单位 ppm (整数)
- 时间戳: Unix 时间戳,精度为秒
- 标签
以下行协议表示上述模式
对于本教程,您可以将此行协议作为字符串直接传递给 influxdb3 write
命令,通过 stdin
传递,或者您可以将其保存到文件并从中读取。
将行协议写入 InfluxDB
使用 influxdb3 write
命令 将家庭传感器示例数据写入 InfluxDB 3 Core。 提供以下信息
使用
--database
选项的数据库名称使用
-t
、--token
选项的 InfluxDB 3 Core 授权令牌行协议。 通过以下方式之一提供行协议
- 字符串
- 包含行协议的文件路径,使用
--file
选项 - 来自 stdin
InfluxDB 3 Core 通过识别哪个精度导致时间戳相对接近“现在”来自动检测时间戳精度。
在您的终端中,输入以下命令来创建示例数据文件
echo 'home,room=Living\ Room temp=21.1,hum=35.9,co=0i 1641024000 home,room=Kitchen temp=21.0,hum=35.9,co=0i 1641024000 home,room=Living\ Room temp=21.4,hum=35.9,co=0i 1641027600 home,room=Kitchen temp=23.0,hum=36.2,co=0i 1641027600 home,room=Living\ Room temp=21.8,hum=36.0,co=0i 1641031200 home,room=Kitchen temp=22.7,hum=36.1,co=0i 1641031200 home,room=Living\ Room temp=22.2,hum=36.0,co=0i 1641034800 home,room=Kitchen temp=22.4,hum=36.0,co=0i 1641034800 home,room=Living\ Room temp=22.2,hum=35.9,co=0i 1641038400 home,room=Kitchen temp=22.5,hum=36.0,co=0i 1641038400 home,room=Living\ Room temp=22.4,hum=36.0,co=0i 1641042000 home,room=Kitchen temp=22.8,hum=36.5,co=1i 1641042000' > ./home.lp
输入以下 CLI 命令以从示例文件写入数据
influxdb3 write \ --database
DATABASE_NAME\ --tokenAUTH_TOKEN\ --file ./home.lp
在您的终端中,输入以下命令来创建示例数据文件
echo 'home,room=Living\ Room temp=21.1,hum=35.9,co=0i 1641024000 home,room=Kitchen temp=21.0,hum=35.9,co=0i 1641024000 home,room=Living\ Room temp=21.4,hum=35.9,co=0i 1641027600 home,room=Kitchen temp=23.0,hum=36.2,co=0i 1641027600 home,room=Living\ Room temp=21.8,hum=36.0,co=0i 1641031200 home,room=Kitchen temp=22.7,hum=36.1,co=0i 1641031200 home,room=Living\ Room temp=22.2,hum=36.0,co=0i 1641034800 home,room=Kitchen temp=22.4,hum=36.0,co=0i 1641034800 home,room=Living\ Room temp=22.2,hum=35.9,co=0i 1641038400 home,room=Kitchen temp=22.5,hum=36.0,co=0i 1641038400 home,room=Living\ Room temp=22.4,hum=36.0,co=0i 1641042000 home,room=Kitchen temp=22.8,hum=36.5,co=1i 1641042000' > ./home.lp
输入以下 CLI 命令以从示例文件写入数据
cat ./home.lp | influxdb3 write \ --database
DATABASE_NAME\ --tokenAUTH_TOKEN
替换以下内容
DATABASE_NAME
: 要写入的数据库的名称AUTH_TOKEN
: 您的 InfluxDB 3 Core 授权令牌在 Beta 期间,InfluxDB 3 Core 不需要授权令牌。
此页内容是否有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一份子!我们欢迎并鼓励您提供关于 InfluxDB 3 Core 和本文档的反馈和错误报告。要获得支持,请使用以下资源
拥有年度合同或支持合同的客户可以联系 InfluxData 支持。