大网数据广告活动
数据库部署与 SQL 参考

功能边界:数据分布

· 52CE 我爱测

功能 关键功能点 支持状态 备注 分桶策略 哈希分桶 是 随机分桶 是 (v3.1+) 随机分桶 仅支持明细表 。从 v3.2 版本开始,StarRocks 支持根据集群信息和数据大小动态调整创建的 Tablet 数量。 分桶键数据类型 日期、整数、字符串 是 分桶数量 自动设置分桶数量 是 (v3.0+) 自动根据 BE 节点数量或最大历史分区的数据量确定。 后续版本对分区表和非分区表分别进行了优化。 随机分桶按需动态增加分桶数量 是 (v3.2+)

功能边界:数据分布

本文档概述了 StarRocks 支持的分区和分桶功能。

支持的表类型

  • 分桶

    所有表类型均支持哈希分桶。随机分桶从 v3.1 版本开始支持,仅支持明细表。

  • 分区

    从 v3.1 版本开始,表达式分区、Range 分区和 List 分区均支持所有表类型。

分桶

功能 关键功能点 支持状态 备注
分桶策略 哈希分桶 是
随机分桶 是 (v3.1+) 随机分桶仅支持明细表。从 v3.2 版本开始,StarRocks 支持根据集群信息和数据大小动态调整创建的 Tablet 数量。
分桶键数据类型 日期、整数、字符串 是
分桶数量 自动设置分桶数量 是 (v3.0+) 自动根据 BE 节点数量或最大历史分区的数据量确定。
后续版本对分区表和非分区表分别进行了优化。
随机分桶按需动态增加分桶数量 是 (v3.2+)

从 v4.1 版本开始,Tablet 的最大容量已调整为 100 GB。

分区

功能 关键功能点 支持状态 备注
分区策略 表达式分区 是 (v3.1+)
  • 包括基于时间函数表达式的分区(自 v3.0 起)和基于列表达式的分区(自 v3.1 起)
  • 支持的时间函数:date_trunc、time_slice
Range 分区 是 (v3.2+) 从 v3.3.0 起,三种特定时间函数可用于分区键:from_unixtime、from_unixtime_ms、str2date、substr/substring。
List 分区 是 (v3.1+)
分区键数据类型 日期、整数、布尔值 是
字符串 是
  • 仅表达式分区和 List 分区支持字符串类型的分区键。
  • Range 分区不支持字符串类型的分区键。需要使用 str2date 将列转换为日期类型。

分区策略的区别

表达式分区 Range 分区 List 分区
基于时间函数表达式的分区 基于列表达式的分区
数据类型 日期 (DATE/DATETIME)
  • 字符串 (除 BINARY)
  • 日期 (DATE/DATETIME)
  • 整数和布尔值
  • 字符串 (除 BINARY) [1]
  • 日期或 Timestamp [1]
  • 整数
  • 字符串 (除 BINARY)
  • 日期 (DATE/DATETIME)
  • 整数和布尔值
支持多个分区键 /(仅支持一个日期类型的分区键) 是 是 是
支持分区键的 Null 值 是 / [2] 是 / [2]
在数据导入前手动创建分区 / [3] / [3]
  • 如果分区是批量手动创建的,则需要手动创建
  • 如果采用动态分区策略,则无需手动创建
是
在数据导入时自动创建分区 是 是 / /
  • [1]: 需要使用 from_unixtime、str2date 或其他时间函数将列转换为日期类型。

  • [2]: 从 v3.3.3 版本起,List 分区的分区键将支持 Null 值。

  • [3]: 分区将自动创建。

有关 List 分区和表达式分区的详细比较,请参阅 List 分区和表达式分区的区别。

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。