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

明细表

· 52CE 我爱测

建表时支持定义排序键。如果查询的过滤条件包含排序键,则 StarRocks 能够快速地过滤数据,提高查询效率。

明细表

明细表是默认创建的表类型。如果在建表时未指定任何 key,默认创建的是明细表。

建表时支持定义排序键。如果查询的过滤条件包含排序键,则 StarRocks 能够快速地过滤数据,提高查询效率。

明细表适用于日志数据分析等场景,支持追加新数据,不支持修改历史数据。

适用场景

  • 分析原始数据,例如原始日志、原始操作记录等。

  • 查询方式灵活,不需要局限于预聚合的分析方式。

  • 导入日志数据或者时序数据,主要特点是旧数据不会更新,只会追加新的数据。

创建表

例如,需要分析某时间范围的某一类事件的数据,则可以将事件时间(event_time)和事件类型(event_type)作为排序键。

在该业务场景下,建表语句如下:

CREATE TABLE detail (
    event_time DATETIME NOT NULL COMMENT "datetime of event",
    event_type INT NOT NULL COMMENT "type of event",
    user_id INT COMMENT "id of user",
    device_code INT COMMENT "device code",
    channel INT COMMENT "")
ORDER BY (event_time, event_type);

使用说明

  • 排序键:自 v3.3.0 起,明细表支持使用 ORDER BY 指定排序键,可以是任意列的排列组合。如果同时使用 ORDER BY 和 DUPLICATE KEY,则 DUPLICATE KEY 无效。如果未使用 ORDER BY 和 DUPLICATE KEY,则默认选择表的前三列作为排序键。

  • 分桶:

    • 分桶方式:自 v3.1.0 起,StarRocks 支持明细表进行随机分桶(默认分桶方式)。您在建表和新增分区时可以不设置哈希分桶键(即 DISTRIBUTED BY HASH 子句)。在 v3.1.0 之前,StarRocks 仅支持哈希分桶。您在建表和新增分区时必须设置哈希分桶键(即 DISTRIBUTED BY HASH 子句),否则建表失败。哈希分桶键的更多说明,请参见哈希分桶。

    • 分桶数量:自 v2.5.7 起,StarRocks 支持在建表和新增分区时自动设置分桶数量 (BUCKETS),您无需手动设置分桶数量。更多信息,请参见设置分桶数量。

  • 建表时,支持为所有列创建 Bitmap 索引、Bloom Filter 索引。

下一步

建表完成后,您可以创建多种导入作业,导入数据至表中。具体导入方式,请参见导入方案。

  • 导入时,支持追加新数据,不支持修改历史数据。
  • 如果导入两行完全相同的数据,则明细表会将这两行数据视为两行,而不是一行。

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

资料来源与适用范围

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

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

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