文档文档

将 Line Protocol 数据写入 InfluxDB Clustered

了解构建和写入 Line Protocol 数据的基础知识。使用诸如 influxctl CLI 和 InfluxDB 客户端库之类的工具来构建 Line Protocol,然后将其写入 InfluxDB 数据库。

您可以使用这些工具从头开始构建 Line Protocol,或者将您的数据转换为 Line Protocol。但是,如果您已经有 CSV 数据,您可能希望使用 使用 CSV 并将其作为 Line Protocol 写入 InfluxDB 的工具

Line Protocol

写入 InfluxDB 的所有数据都使用 Line Protocol 写入,这是一种基于文本的格式,可让您提供必要的信息以将数据点写入 InfluxDB。

Line Protocol 元素

在 InfluxDB 中,一个点包含一个 measurement 名称、一个或多个字段、一个时间戳和可选的标签,这些标签提供有关观测的元数据。

Line Protocol 的每一行包含以下元素

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

Line Protocol 元素解析

  • measurement第一个未转义的逗号之前,第一个空格之前的所有内容。
  • tag set第一个未转义的逗号第一个未转义的空格之间的键值对。
  • field set第一个和第二个未转义的空格之间的键值对。
  • timestamp第二个未转义的空格之后的整数值。
  • 行由换行符 (\n) 分隔。Line Protocol 对空格敏感。

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


有关模式设计建议,请参阅 InfluxDB 模式设计

将 Line Protocol 写入 InfluxDB


此页是否对您有帮助?

感谢您的反馈!


Flux 的未来

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

阅读更多

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

InfluxDB 3 开源版本现已可用于 Alpha 测试,根据 MIT 或 Apache 2 许可获得许可。

我们正在发布两个产品作为 Alpha 测试的一部分。

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

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