一. 概念说明

维度扩展是一种在不调整加速表结构的前提下，支持在查询阶段灵活使用更多维度进行分析的能力。

通过维度扩展，系统可以在查询时自动补齐所需维度字段，并在后台完成必要的汇总计算，从而保证查询结果正确且高效。

1. 为什么需要维度扩展？

在指标分析中，常见会遇到以下问题：

业务分析过程中，查询维度经常变化
维度表更新频繁，但不希望因此触发历史加速数据重算
查询新增维度后，原有加速方案无法命中

维度扩展正是为了解决这些问题而设计，使加速方案更加灵活、稳定。

2. 维度扩展的核心思路

维度扩展遵循以下原则：

加速表仅保存核心分析粒度
如：指标日期、业务主键（用户ID、商品ID、门店ID 等）
维度字段不强制写入加速表
维度在查询时按需补齐
查询结果自动完成汇总
确保与查询维度粒度一致

对用户而言，查询方式与普通指标查询一致，无需关心中间过程。

二、使用示例

示例一：基础维度扩展（单一路径）

业务场景：在已有订单指标加速的基础上，希望按用户等级、城市等维度进行分析
系统怎么做：系统在查询时基于用户 ID 自动补齐用户维度并完成结果汇总
用户能得到什么：无需调整加速方案即可灵活使用新增维度进行分析

在不修改加速方案的前提下，系统基于用户 ID 自动补齐用户等级和城市等维度，并返回按查询维度汇总的分析结果。

如有以下模型关系：

存在物化方案如下配置：

指标日期，用户ID，总订单额

此时通过以下查询可命中加速

指标日期，用户等级，用户市，总订单额

示例二：同一维度来自不同业务路径

业务场景：同一指标中需要同时分析开户机构地区和交易机构地区
系统怎么做：系统按不同业务路径分别补齐对应的维度字段
用户能得到什么：不同业务语义的维度清晰区分，分析结果更符合业务理解

系统支持同一维度字段通过不同业务路径分别补齐，确保复杂分析场景下维度语义清晰准确。

存在物化方案如下配置：

用户 ID, 交易机构 ID，总金额

此时通过以下查询可命中加速：

开户地区, 交易机构归属地区, 总金额

三注意事项与限制

在使用维度扩展前，请重点关注以下限制与建议。

不适用的场景

1、不支持再次汇总的指标

明细级查询
不可上卷（不可聚合）的指标
强依赖唯一行语义的指标

2、加速表中缺少关联键

如果加速表中：

不包含任何可以关联到查询维度的字段（如主键、业务ID）

则系统无法补齐维度，维度扩展不会生效。

3、不支持复杂表达式维度

目前仅支持：

表中的原始字段作为维度

暂不支持：

复杂计算字段
表达式型维度