# 模型设计

<!-- BookStack import page: id=bm-model chapter=业务建模中心 -->

## 功能定位

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

![模型设计](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-elknjzn4.png)

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

## 适用角色

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

## 页面入口

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

## 操作步骤

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

## 输入与输出

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

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

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

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

![第1步重点操作：进入“业务建模中心 → 模型设计”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-zgcmscui.jpeg)

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

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

### 第二步：填写 `MODEL_SALES_ORDER_FACT`

![第2步重点操作：填写 `MODEL_SALES_ORDER_FACT`](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-boasyn4q.jpeg)

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

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

### 第三步：选择订单来源表

![第3步重点操作：选择订单来源表](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-kmcwpn5e.jpeg)

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

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

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

![第4步重点操作：为销售额、数量、折扣额、毛利额设置聚合方式和字段](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-wotr4p1w.jpeg)

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

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

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

![第5步重点操作：关联同项目的产品、客户、组织和日期维度模型](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-3gfmu3no.jpeg)

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

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

### 第六步：查看编译结果

![第6步重点操作：查看编译结果](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-lr92uw8s.jpeg)

*步骤图 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}`；事实模型必须有粒度说明。