明细表

明细表是默认创建的表类型。如果在建表时未指定任何 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 索引。

下一步

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

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