使用 influxdb3 CLI 写入数据
使用 influxdb3 CLI 将行协议数据写入 InfluxDB 3 Core。
使用 API 进行批量和高流量写入
influxdb3 CLI 可让您快速开始向 InfluxDB 3 Core 写入数据。对于批量和高流量写入工作负载,请使用 InfluxDB HTTP API、API 客户端库 或 Telegraf。
构建行协议
通过对 行协议有基本了解,您可以构造行协议格式的数据并将其写入 InfluxDB 3 Core。考虑一个用例,您在家中从传感器收集数据。每个传感器收集温度、湿度和一氧化碳读数。要收集此数据,请使用以下模式:
- 表 (table):
home- 标签 (tags)
room:Living Room 或 Kitchen
- 字段 (fields)
temp:温度(摄氏度,浮点数)hum:湿度百分比(浮点数)co:一氧化碳(百万分之几,整数)
- 时间戳 (timestamp):以秒精度为单位的 Unix 时间戳
- 标签 (tags)
以下行协议表示上述模式
对于本教程,您可以直接将此行协议作为字符串通过 stdin 传递给 influxdb3 write 命令,也可以将其保存到文件并从中读取。
将行协议写入 InfluxDB
使用 influxdb3 write 命令 将家庭传感器示例数据写入 InfluxDB 3 Core。提供以下内容:
使用
--database选项指定 数据库 名称使用
-t、--token选项指定您的 InfluxDB 3 Core 令牌行协议。以以下方式之一提供行协议:
- 字符串
- 包含行协议的文件路径,使用
--file选项 - 来自 stdin
默认情况下,InfluxDB 3 Core 使用时间戳的幅度自动检测精度。要指定数据中时间戳的精度,请使用 --precision {ns|us|ms|s} 选项。
在终端中,输入以下命令创建示例数据文件:
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 \ --databaseDATABASE_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 \ --databaseDATABASE_NAME\ --tokenAUTH_TOKEN
替换以下内容:
DATABASE_NAME:要写入的数据库名称AUTH_TOKEN:您的 InfluxDB 3 Core 令牌
此页面是否有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一员!我们欢迎并鼓励您对 InfluxDB 3 Core 和本文档提供反馈和错误报告。要获得支持,请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。