将行协议数据写入 InfluxDB 集群

了解构建和写入行协议数据的基本知识。使用像 influxctl CLI 和 InfluxDB 客户端库这样的工具构建行协议，并将其写入 InfluxDB 数据库。

您可以使用这些工具从头开始构建行协议或将数据转换为行协议。但是，如果您已经有 CSV 数据，您可能希望使用能够消费 CSV 并将其作为行协议写入 InfluxDB 的工具。

• 行协议
  • 行协议元素
• 将行协议写入 InfluxDB

行协议

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

行协议元素

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

行协议的每一行包含以下元素

• * 测量：一个字符串，用于标识存储数据的表。
• 标签集：逗号分隔的键值对列表，每个标签代表一个标签。标签键和值是不加引号的字符串。空格、逗号和等号字符必须转义。
• * 字段集：逗号分隔的键值对列表，每个字段代表一个字段。字段键是不加引号的字符串。空格和逗号必须转义。字段值可以是字符串（加引号）、浮点数、整数、无符号整数或布尔值。
• 时间戳：与数据关联的Unix时间戳。InfluxDB支持高达纳秒级的精度。如果时间戳的精度不是纳秒级，则在将数据写入InfluxDB时必须指定精度。

行协议元素解析

• 测量：在第一个空白字符之前（包括第一个未转义的逗号）的所有内容。
• 标签集：在第一个未转义的逗号和第一个未转义的空白字符之间的键值对。
• 字段集：在第一个和第二个未转义的空白字符之间的键值对。
• 时间戳：在第二个未转义的空白字符之后的整数值。
• 行之间由换行符（\n）分隔。行协议对空白敏感。

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

将行协议写入 InfluxDB