将数据写入 InfluxDB 3 Core
InfluxDB 3 Core 处于公开 Alpha 阶段
InfluxDB 3 Core 处于公开 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, field1="v1",field2=1i
有关模式设计建议,请参阅 InfluxDB 模式设计。
将数据写入 InfluxDB
使用 influxdb3 CLI 写入数据
使用 influxdb3
CLI 将行协议数据写入 InfluxDB Clustered。
使用 Telegraf 写入数据
使用 Telegraf 收集数据并将数据写入 InfluxDB 3 Core。
使用 InfluxDB 客户端库写入数据
使用 InfluxDB API 客户端将点作为行协议数据写入 InfluxDB Clustered。
写入数据的最佳实践
了解关于将数据写入 InfluxDB 3 Core 的建议和最佳实践。
问题排查数据写入问题
问题排查数据写入问题。查找写入失败的响应代码。了解写入失败的原因,从超出速率或有效负载限制到语法错误和模式冲突。
此页内容对您有帮助吗?
感谢您的反馈!
支持与反馈
感谢您成为我们社区的一份子!我们欢迎并鼓励您提供关于 InfluxDB 3 Core 和本文档的反馈和错误报告。如需获得支持,请使用以下资源
拥有年度或支持合同的客户可以联系 InfluxData 支持。