Documentation

将行协议数据写入 InfluxDB Cloud Serverless

学习构建和编写行协议数据的基础知识。使用像 Telegraf 和 InfluxDB 客户端库这样的工具来构建行协议,然后将其写入 InfluxDB 存储桶。

您可以使用这些工具从头开始构建行协议或将您的数据转换为行协议。 然而,如果您已经拥有CSV数据,您可能想要使用消耗CSV并将其写入InfluxDB作为行协议的工具。

行协议

所有写入InfluxDB的数据都是使用 行协议写入的,这是一种基于文本的格式,允许您提供写入数据点到InfluxDB所需的信息。

行协议元素

在 InfluxDB 中,一个点包含一个测量名称、一个或多个字段、一个时间戳,以及提供关于观测的元数据的可选标签。

每行行协议包含以下元素:

* Required
  • * measurement: 用于标识要存储数据的 measurement的字符串。
  • 标签集: 由逗号分隔的键值对列表,每个代表一个标签。标签的键和值是未加引号的字符串。空格、逗号和等号字符必须被转义。
  • * 字段集合: 以逗号分隔的键值对列表,每个代表一个字段。 字段键是未引用的字符串。 空格和逗号必须被转义。 字段值可以是 字符串 (引用的), 浮点数, 整数, 无符号整数, 或 布尔值
  • timestamp: Unix 时间戳 与数据相关。InfluxDB 支持高达纳秒的精度。 如果时间戳的精度不是纳秒,你必须在将数据写入 InfluxDB 时指定精度。

行协议元素解析

  • measurement: 在第一个未转义的逗号之前的第一个空格之前的所有内容。
  • 标签集: 在第一个未转义的逗号第一个未转义的空白字符之间的键值对。
  • 字段集: 在第一个和第二个未转义的空白字符之间的键值对。
  • timestamp: 在第二个未转义空格之后的整数值。
  • 行通过换行符分隔 (\n)。行协议对空格敏感。

myMeasurement,tag1=val1,tag2=val2 field1="v1",field2=1i 0000000000000000000


有关架构设计建议,请参阅 InfluxDB 架构设计

将行协议写入InfluxDB



Flux的未来

Flux 正在进入维护模式。您可以像现在一样继续使用它,而无需对您的代码进行任何更改。

阅读更多

InfluxDB 3 开源版本现已公开Alpha测试

InfluxDB 3 Open Source is now available for alpha testing, licensed under MIT or Apache 2 licensing.

我们将发布两个产品作为测试版的一部分。

InfluxDB 3 核心,是我们新的开源产品。 它是一个用于时间序列和事件数据的实时数据引擎。 InfluxDB 3 企业版是建立在核心基础之上的商业版本,增加了历史查询能力、读取副本、高可用性、可扩展性和细粒度安全性。

有关如何开始的更多信息,请查看:

InfluxDB 云端无服务器