模型设计

功能定位

模型设计把已审核的指标、维度和来源表组合为事实模型、维度模型或桥接模型，并编译为 dbt/Doris 可执行的模型定义。

图 6-11　模型字段、度量、关系和编译结果

适用角色

数据模型工程师、数据架构师和 BI 管理员。

页面入口

业务建模中心 → 模型设计（/bi/bm/model）。

操作步骤

1. 选择项目，点击“新建模型”，填写以 MODEL_ 开头的编码、名称和类型。
2. 事实模型必须填写事实粒度，例如“一行一个销售订单明细”。
3. 选择来源表，配置字段角色：主键、维度、度量、属性或时间。
4. 为度量设置聚合方式和聚合字段；为维度模型配置主键和属性。
5. 事实模型可添加指向同项目 DIM 模型的关系，选择关系类型和关联字段。
6. 查看“编译结果”中的 SQL/DDL、依赖和校验问题。
7. 保存草稿、提交审核；审核通过后生成不可变版本。
8. 在发布中心选择审核版本，沿固定发布链登记到数据平台。

输入与输出

输入是来源表、字段映射、度量、关系和模型类型；输出是可审核的模型定义、编译结果和版本快照。

客户应用演示：创建“宏澜销售订单事实模型”

业务情境： 已审核的销售额、毛利额和维度需要组合成可发布的事实模型。

第一步：进入“业务建模中心 → 模型设计”

步骤图 33-01　第1步：进入“业务建模中心 → 模型设计”。红框标出进入业务建模中心 → 模型设计。

进入“业务建模中心 → 模型设计”，选择销售项目，新建模型。

第二步：填写 MODEL_SALES_ORDER_FACT

步骤图 33-02　第2步：填写 MODEL_SALES_ORDER_FACT。红框标出填写 MODEL_SALES_ORDER_FACT。

填写 MODEL_SALES_ORDER_FACT，选择事实模型，粒度设为“一行一个订单明细”。

第三步：选择订单来源表

步骤图 33-03　第3步：选择订单来源表。红框标出选择订单来源表。

选择订单来源表，配置订单号、客户、产品、组织、日期和金额字段角色。

第四步：为销售额、数量、折扣额、毛利额设置聚合方式和字段

步骤图 33-04　第4步：为销售额、数量、折扣额、毛利额设置聚合方式和字段。红框标出为销售额、数量、折扣额、毛利额设置聚合方式和字段。

为销售额、数量、折扣额、毛利额设置聚合方式和字段。

第五步：关联同项目的产品、客户、组织和日期维度模型

步骤图 33-05　第5步：关联同项目的产品、客户、组织和日期维度模型。红框标出关联同项目的产品、客户、组织和日期维度模型。

关联同项目的产品、客户、组织和日期维度模型。

第六步：查看编译结果

步骤图 33-06　第6步：查看编译结果。红框标出查看编译结果。

查看编译结果，修正字段或类型问题后保存并提交审核。

最终结果与效果

模型形成可审核的字段映射、度量、关系和编译结果；审核通过后生成不可变版本。

操作提示： 事实模型必须写清粒度；未经审核的维度模型不能作为关联目标。

当前演示环境说明

当前模型设计页显示 4 个已发布模型：宏澜销售订单事实模型、宏澜产品维度模型、宏澜客户维度模型和宏澜财务期间事实模型。

宏澜家电示例

“宏澜销售订单事实模型”以订单明细为粒度，包含订单金额、数量、折扣额和毛利额度量；关联产品、客户、组织和日期维度。模型审核后发布到 dbt、Doris、OpenMetadata 和 Superset。

常见问题

无法关联某个维度模型。 关系只能指向同项目且已审核通过的 DIM 模型。

编译提示字段不存在。 回到来源表和字段映射检查字段名、类型和来源表版本。

模型已修改但发布记录未变化。 发布只接受审核版本；修改后需重新提交审核。

开发人员参考

• 接口：/bi/bm/projects/{projectId}/models、.../compile、.../submit、.../review、.../versions
• 权限：bi:bm:model:edit、bi:bm:model:submit、bi:bm:model:review
• 模型编码格式为 MODEL_[A-Z0-9_]{2,56}；事实模型必须有粒度说明。