文档说明

分区模板

使用分区模板定义生成分区键的模式。分区键唯一标识分区,并用于在 对象存储 中命名分区 Parquet 文件。

分区模板由 1-8 个 模板部分 组成——按数据分区维度。存在三种类型的模板部分:

  • 标签:用于分区的 InfluxDB 标签
  • 标签桶:一个 InfluxDB 标签 和将标签值分组到其中的“桶”数量。数据按标签桶而不是每个不同的标签值分区。
  • * 必需 时间:指定按数据分区时间的 Rust strftime 日期和时间字符串。时间部分模板中包含的最小时间单位是用于分区的间隔。

分区模板必须包括 1 个 时间部分,最多可以包含 7 个总 标签标签桶 部分。

限制

模板部分大小限制

每个模板部分长度限制为 200 字节。超过 200 字节的内容将在 200 字节处截断,并附加 #

分区键大小限制

在截断模板部分后,分区键的最大长度为 1,607 字节(1.57 KiB)。

保留关键字

以下保留关键字不能用于分区模板

  • time

保留字符

如果在模板部分中使用,非 ASCII 字符和以下保留字符必须进行 百分号编码

  • |:分区键部分分隔符
  • !:空或缺失的分区键部分
  • ^:空字符串分区键部分
  • #:键部分截断标记
  • %:用于明确反转百分号编码的必需项

标签部分模板

标签部分模板由一个 标签键 组成,用于分区。生成的分区键包括每个分区特定的唯一 标签值

分区模板可能只包含一次给定的标签键,在操作标签的模板部分中(标签值和标签桶)—例如

如果模板根据 tag_A 的唯一值进行分区,则不能将 tag_A 作为标签桶部分使用。

标签桶部分模板

标签桶部分模板由一个用于分区的 标签键 和将标签值分区的 “桶”数 组成—例如

customerID,500

customerID 标签的值被分入 500 个不同的“桶”。每个桶由标签值除以指定的桶数后得到的 32 位整数余数来标识

hash(tagValue) % N

生成的分区键包括每个分区特有的 标签桶标识符

支持的标签桶数量: 1-1,000

标签桶应该用于分区高基数标签或具有未知数量不同值的标签。

分区模板可能只包含一次给定的标签键,在操作标签的模板部分中(标签值和标签桶)—例如

如果模板根据 tag_A 的唯一值进行分区,则不能将 tag_A 作为标签桶部分使用。

时间部分模板

时间部分模板使用 Rust strftime 日期和时间格式化语法的有限子集来指定分区键中的时间格式。InfluxDB 使用时间部分模板中包含的最小时间单位作为分区间隔。

日期指定符

变量示例描述
%Y2001完整的协历公历年,前导零填充到 4 位。chrono 支持从 -262144 到 262143 年。注意:公元前 1 年或公元 9999 年之后的年份,需要初始符号(±)。
%m07月份(01–12),前导零填充到 2 位。
%d08日(01–31),前导零填充到 2 位。

这个页面有帮助吗?

感谢您的反馈!


Flux 的未来

Flux 正在进入维护模式。您可以继续按当前方式使用它,而无需对您的代码进行任何更改。

阅读更多

InfluxDB v3 增强功能和 InfluxDB 集群现在已公开发布

新功能,包括更快的查询性能和管理工具,推进了 InfluxDB v3 产品线。InfluxDB 集群现在已公开发布。

InfluxDB v3 性能和功能

InfluxDB v3产品线在查询性能方面进行了显著增强,并提供了新的管理工具。这些增强包括用于监控InfluxDB集群健康状况的操作仪表板,InfluxDB Cloud Dedicated中的单点登录(SSO)支持,以及用于令牌和数据库的新管理API。

了解v3的新增强功能


InfluxDB集群版正式发布

InfluxDB集群版现已正式发布,您可以在自管理堆栈中享受到InfluxDB v3的强大功能。

与我们讨论InfluxDB集群版