表模型决定写入语义

StarRocks 的表模型不只是存储结构，它直接定义了同主键多次写入会发生什么：追加不去重、按 key 聚合、按 key 覆盖。选错模型的表现往往很隐蔽——维表用了聚合模型，取值变成求和；指标表用了明细模型，重复导入就重复计数。建表时想清楚数据是「只追加」还是「需要最新态」。

基本信息

典型使用场景

• 维表：主键模型按主键覆盖，永远保留最新属性
• 指标汇总：聚合模型写入即聚合，查询时合并结果
• 行为日志：明细模型追加，保留每条原始记录
• 状态表：主键模型配合部分列更新，只更新变化的列
• 宽表指标：主键模型承载需要频繁更新的结果表

主键模型示例

CREATE TABLE dw.dim_store (
  store_id    VARCHAR(32) NOT NULL,
  store_name  VARCHAR(128),
  region_id   VARCHAR(32),
  update_time DATETIME
)
PRIMARY KEY (store_id)
DISTRIBUTED BY HASH(store_id) BUCKETS 8
PROPERTIES (
  'replication_num' = '3'   -- 副本数按集群规格调整
);
-- 同一 store_id 再次导入会覆盖旧行，不会产生重复

表模型对照

怎么选模型

先问数据是否可重复写入：可以重复写入且需要覆盖的，用主键模型；只追加不回头的，用明细模型；写入端已经做过聚合、且查询总是按同一组维度求和的，才考虑聚合模型。维表用聚合模型是最常见的错配，取值会被隐式求和，表面上数据还在，语义已经变了。