使用 influxdb3 CLI 写入数据
InfluxDB 3 Core 现已公开发布 Alpha 版本
InfluxDB 3 Core 现已公开发布 alpha 版本,可用于测试和反馈,但不适用于生产环境。该产品和本文档都仍在开发中。我们欢迎并鼓励您提供关于 alpha 版本使用体验的反馈,并邀请您加入我们的公共频道以获取更新和分享反馈。
使用 influxdb3
CLI 将 Line Protocol 数据写入 InfluxDB 3 Core。
构建 Line Protocol
在基本了解 Line Protocol之后,您现在可以构建 Line Protocol 并将数据写入 InfluxDB 3 Core。考虑一个用例,您从家中的传感器收集数据。每个传感器收集温度、湿度和一氧化碳读数。要收集此数据,请使用以下模式
- 表:
home
- 标签
room
:客厅或厨房
- 字段
temp
:温度,单位 °C(浮点数)hum
:湿度百分比(浮点数)co
:一氧化碳,单位百万分之几 (ppm)(整数)
- 时间戳:Unix 时间戳,精度为秒
- 标签
以下 Line Protocol 表示上述模式
对于本教程,您可以将此 Line Protocol 作为字符串直接传递给 influxdb3 write
命令,通过 stdin
传递,或者您可以将其保存到文件并从文件中读取。
将 Line Protocol 写入 InfluxDB
使用 influxdb3 write
命令 将家庭传感器示例数据写入 InfluxDB 3 Core。提供以下信息:
使用
--database
选项的数据库名称您的 InfluxDB 3 Core 授权令牌,使用
-t
、--token
选项Line Protocol。通过以下方式之一提供 Line Protocol:
- 字符串
- 包含 Line Protocol 的文件的路径,使用
--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\ ./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 授权令牌在 alpha 测试期间,InfluxDB 3 Core 不需要授权令牌。
此页内容是否对您有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一份子!我们欢迎并鼓励您提供关于 InfluxDB 3 Core 和本文档的反馈和错误报告。要获得支持,请使用以下资源:
拥有年度或支持合同的客户可以联系 InfluxData 支持。