分区模板
使用分区模板定义生成分区键的模式。分区键唯一标识分区,并用于在 对象存储 中命名分区 Parquet 文件。
分区模板由 1-8 个 模板部分 组成——按数据分区维度。存在三种类型的模板部分:
- 标签:用于分区的 InfluxDB 标签。
- 标签桶:一个 InfluxDB 标签 和将标签值分组到其中的“桶”数量。数据按标签桶而不是每个不同的标签值分区。
- * 必需 时间:指定按数据分区时间的 Rust strftime 日期和时间字符串。时间部分模板中包含的最小时间单位是用于分区的间隔。
限制
模板部分大小限制
每个模板部分长度限制为 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 使用时间部分模板中包含的最小时间单位作为分区间隔。
日期指定符
变量 | 示例 | 描述 |
---|---|---|
%Y | 2001 | 完整的协历公历年,前导零填充到 4 位。chrono 支持从 -262144 到 262143 年。注意:公元前 1 年或公元 9999 年之后的年份,需要初始符号(±)。 |
%m | 07 | 月份(01–12),前导零填充到 2 位。 |
%d | 08 | 日(01–31),前导零填充到 2 位。 |
这个页面有帮助吗?
感谢您的反馈!