文档文档

将数据写入 InfluxDB 3 Core

InfluxDB 3 Core 处于公开 Alpha 阶段

InfluxDB 3 Core 处于公开 alpha 阶段,可用于测试和反馈,但不适用于生产环境。产品和本文档均在不断完善中。我们欢迎并鼓励您提供关于 alpha 体验的反馈,并邀请您加入我们的公共频道以获取更新和分享反馈。

Alpha 预期和建议

使用 influxctl CLI、Telegraf 和 InfluxDB 客户端库等工具将时间序列数据写入 InfluxDB 3 Core。行协议是用于将数据写入 InfluxDB 的基于文本的格式。有工具可用于将其他格式(例如—CSV)转换为行协议。

为您的工作负载选择写入端点

当引入现有的 v1 写入工作负载时,请使用 InfluxDB 3 Core HTTP API /write 端点。当创建新的写入工作负载时,请使用 HTTP API /api/v2/write 端点

行协议

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

行协议元素

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

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

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

行协议元素解析

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

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


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

将数据写入 InfluxDB


此页内容对您有帮助吗?

感谢您的反馈!


Flux 的未来

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

阅读更多

InfluxDB 3 开源版本现已公开发布 Alpha 版

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

作为 Alpha 版本的一部分,我们发布两款产品。

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

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