创建模型
功能概览
功能定位
创建模型用于按业务分类、数据分域、数仓分层和表类型建立逻辑模型，并维护模型的属性字段。模型保存后，可在【发布模型】页面选择目标数据库进行发布。
简单理解：先确定模型归属和表名，再补齐字段；如果已有物理表，也可以直接读取它的字段生成模型。
使用建议
先确认业务分类、数据分域和数仓分层等上游信息，再根据来源选择【手工录入】或【物化表生成】。提交前重点核对完整表名、字段类型、主键和必填属性。
主要特性
- 模型检索：按左侧分类树、模型中文名称、英文名称和数仓分层定位逻辑模型。
- 多种建模方式：通过【明细表】、【汇总表】、【维度表】或【应用表】选择表类型，并支持手工录入或物化表生成。
- 字段维护：新增属性字段，设置数据类型、长度、主键和必填属性。
作用范围
本页覆盖逻辑模型的查询、创建、字段维护、修改、详情、状态和删除入口；不负责把逻辑模型发布到数据库，也不定义数据开发任务和调度。
范围提示
【确定】保存的是逻辑模型配置；要将模型结构同步到数据库，还需进入【发布模型】页面执行发布。
前置步骤
前置条件
- 已登录 qData 平台。
- 已进入【数据建模】模块。
- 业务分类、数据分域和数仓分层已经维护。
- 使用【物化表生成】时，目标数据连接和来源表可用。
导航路径
数据建模 > 逻辑模型 > 创建模型
页面总览
页面左侧提供分类树，右侧包含模型查询区、【创建表】入口和逻辑模型列表。列表可查看模型名称、归属层级、表类型、状态和操作入口。
推荐操作流程
手工建模：定位模型范围 → 选择表类型 → 选择【手工录入】→ 填写基础信息 → 新增属性字段 → 提交并核对列表结果。
物化表生成：选择表类型 → 选择【物化表生成】→ 选择数据连接和来源表 → 核对自动带出的字段 → 提交并核对列表结果。
功能操作说明
查询逻辑模型和选择表类型
- 在左侧分类树中选择目标节点。
- 输入模型中文名称、英文名称或选择数仓分层。
- 如需显示更多查询条件，点击【展开】。
- 点击【查询】。
- 查看匹配的模型记录和表类型。
- 点击【重置】恢复默认结果。
- 点击【创建表】。
- 选择【明细表】、【汇总表】、【维度表】或【应用表】。
页面打开“新增逻辑模型”表单后，继续选择创建方式。
手工录入逻辑模型
- 在“创建方式”中选择【手工录入】。
- 填写模型基础信息。
| 字段名 | 说明 | 是否必填 |
|---|---|---|
| 创建方式 | 选择手工录入或物化表生成。 | 是 |
| 业务分类 | 选择模型的业务归属。 | 是 |
| 数据分域 | 选择模型的数据边界。 | 是 |
| 数仓分层 | 选择模型所在的数仓层级。 | 是 |
| 表英文名称 | 填写模型英文表名，并参与完整表名生成。 | 是 |
| 表中文名称 | 填写模型中文名称。 | 是 |
| 完整表名 | 查看或选择按命名规则形成的完整表名。 | 是 |
| 标准类型 | 按需选择国家、行业、地方或团体标准。 | 否 |
| 标准登记 | 按需选择关联的标准文件。 | 否 |
| 责任人 | 按需选择模型责任人。 | 否 |
| 联系电话 | 显示所选责任人对应的联系电话。 | 否 |
| 状态 | 选择禁用或启用；表单默认禁用。 | 否（系统默认） |
| 描述 | 填写模型用途说明。 | 否 |
| 备注 | 填写补充说明。 | 否 |
- 核对表英文名称、表中文名称和完整表名。
- 在属性字段区域点击【新增】。
- 完成属性字段维护后，点击【确定】。
- 返回列表核对新增模型和保存结果。
新增属性字段
- 在属性字段区域点击【新增】。
- 填写属性字段信息。
| 字段名 | 说明 | 是否必填 |
|---|---|---|
| 关联标准 | 选择字段引用的标准数据元或标准。 | 否 |
| 中文名称 | 填写字段的中文业务名称。 | 是 |
| 英文名称 | 填写数据库字段名。 | 是 |
| 数据类型 | 选择字段数据类型，如 VARCHAR、TINYINT、INTEGER、BIGINT 或 DECIMAL。 | 是 |
| 属性长度 | 填写字段长度。 | 是 |
| 小数位数 | 数值字段按需填写精度。 | 否 |
| 默认值 | 按需填写字段默认值。 | 否 |
| 描述 | 填写字段用途说明。 | 否 |
| 是否主键 | 设置字段是否作为主键。 | 是 |
| 是否必填 | 设置字段是否允许为空。 | 是 |
- 点击【确认】保存字段。
- 在属性字段列表中核对字段名称、类型和长度。
- 按需编辑、删除字段或切换主键状态。
从物化表生成模型
- 在“创建方式”中选择【物化表生成】。
- 选择数据连接名称。
- 核对系统带出的数据库类型和数据库地址。
- 在“选择表”字段中选择来源表。
- 核对系统读取的字段英文名称、数据类型和长度。
- 补充模型业务分类、数据分域、数仓分层和名称等信息。
- 点击【确定】提交模型。
- 返回列表检查生成结果。
修改、查看和维护模型
- 在模型列表中定位目标记录。
- 点击【修改】调整模型基础信息或属性字段。
- 点击【详情】查看模型结构和详细信息。
- 使用状态开关切换启用或禁用状态。
- 如需删除，点击【删除】并按页面当前提示确认。
- 返回列表核对最新内容和状态。
操作提示
保存或修改后，先核对模型归属、完整表名、字段类型、主键和必填属性，再在【发布模型】页面继续发布。删除操作的具体结果以页面当前确认提示为准。
常见问题
完整表名如何形成？
完整表名会结合数仓分层、业务分类、数据分域和表英文名称等信息形成；如需核对，应同时检查这些归属和命名字段。手工录入和物化表生成有什么区别？
手工录入用于从零设计表结构；物化表生成用于选择数据连接和来源表，并读取来源表字段生成模型。创建模型后为什么还要进入【发布模型】？
创建模型页面保存的是逻辑模型配置；将模型结构同步到目标数据库需要在【发布模型】页面执行发布。
总结
创建模型页面覆盖逻辑模型查询、表类型选择、手工建模、物化表生成和字段维护。提交前请重点核对模型归属、完整表名、字段类型、主键和必填属性。