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