将行协议数据写入 InfluxDB Cloud Serverless
学习构建和编写行协议数据的基础知识。使用像 Telegraf 和 InfluxDB 客户端库这样的工具来构建行协议,然后将其写入 InfluxDB 存储桶。
您可以使用这些工具从头开始构建行协议或将您的数据转换为行协议。 然而,如果您已经拥有CSV数据,您可能想要使用消耗CSV并将其写入InfluxDB作为行协议的工具。
行协议
所有写入InfluxDB的数据都是使用 行协议写入的,这是一种基于文本的格式,允许您提供写入数据点到InfluxDB所需的信息。
行协议元素
在 InfluxDB 中,一个点包含一个测量名称、一个或多个字段、一个时间戳,以及提供关于观测的元数据的可选标签。
每行行协议包含以下元素:
* Required- * measurement: 用于标识要存储数据的 measurement的字符串。
- 标签集: 由逗号分隔的键值对列表,每个代表一个标签。标签的键和值是未加引号的字符串。空格、逗号和等号字符必须被转义。
- * 字段集合: 以逗号分隔的键值对列表,每个代表一个字段。 字段键是未引用的字符串。 空格和逗号必须被转义。 字段值可以是 字符串 (引用的), 浮点数, 整数, 无符号整数, 或 布尔值。
- timestamp: Unix 时间戳 与数据相关。InfluxDB 支持高达纳秒的精度。 如果时间戳的精度不是纳秒,你必须在将数据写入 InfluxDB 时指定精度。
行协议元素解析
- measurement: 在第一个未转义的逗号之前的第一个空格之前的所有内容。
- 标签集: 在第一个未转义的逗号和第一个未转义的空白字符之间的键值对。
- 字段集: 在第一个和第二个未转义的空白字符之间的键值对。
- timestamp: 在第二个未转义空格之后的整数值。
- 行通过换行符分隔 (
\n)。行协议对空格敏感。
有关架构设计建议,请参阅 InfluxDB 架构设计。
将行协议写入InfluxDB
使用InfluxDB客户端库来写入行协议数据
使用 InfluxDB API 客户端将点以行协议数据写入 InfluxDB Cloud Serverless。