逻辑模型
1. 逻辑模型简介
逻辑模型是对行业数据资产的一种抽象定义，通过统一的表结构和字段标准，将业务数据标准化、结构化管理，适用于数据建模、数据治理、数据共享等场景。
在 qData 数据中台中，逻辑模型适用于以下典型场景：
- 标准先行：对某类数据统一建模，确保表结构一致；
- 数据治理：保证多源数据归集后结构统一；
- 自动建表：通过物化功能快速生成物理表。
📷 [逻辑模型列表]：逻辑模型管理首页，展示模型列表、状态、创建人等信息
2. 概述
逻辑模型实际表现为系统中预定义的“虚拟表结构”，包含表名、注释及字段定义。主要用途：
- 统一数据标准，便于不同业务系统复用；
- 创建数据库物理表时作为模板使用；
- 支持后续数据资产梳理、模型对齐。
示例场景：
- 某行业中存在“水质监测”数据，可定义逻辑模型
WATER_QUALITY_MONITOR； - 下游应用在建表时直接基于此模型物化，保障结构一致。
📷 [逻辑模型详情]：逻辑模型详情页面，显示模型基础信息与字段列表
3. 新增逻辑模型
qData 支持两种创建逻辑模型的方式：
3.1 手工录入
适用于从零开始定义模型结构的场景。用户需手动填写模型基本信息和字段信息。
填写项包括：
- 中文名称（必填）
- 英文名称（必填）
- 模型类别（必填）
- 状态（启用/禁用）
- 联系人、联系电话（选填）
- 表描述（选填）
字段定义区域可添加字段，填写内容包括字段中文名、英文名、类型、长度、是否主键等。
📷 [新增-手工录入] 手工录入逻辑模型界面
3.2 物化表生成
适用于已有物理表结构，希望直接导入为逻辑模型的场景。系统将从数据库中读取表结构，自动填充字段定义。
填写项在“手工录入”基础上增加了以下字段：
- 数据库连接（必填）
- 数据库类型
- 数据库地址
- 表选择器（选择需要物化的表）
系统将读取所选物理表的字段信息，填充到字段定义区，用户可继续调整或补充说明。
📷 [新增-物化表生成] 基于物化表生成逻辑模型界面
创建完成后，点击【确认】按钮，系统将保存该模型并跳转至详情页，后续可配置字段或进行物理表生成。
4. 查看详情
在模型列表中点击某一行的 【详情】 按钮，进入查看页面，可查看：
- 模型基本信息（编码、名称、创建时间等）；
- 字段信息（字段名、类型、主键标识、默认值等）。
字段支持分页查看。
📷 [逻辑模型详情]：逻辑模型详情页，展示字段列表和元数据
5. 配置模型字段
字段配置是逻辑模型的核心功能，相当于数据库建表时的字段定义。
支持的字段属性包括：
| 属性 | 描述 |
|---|---|
| 字段英文名 | 例如：ID、DEVICE_CODE |
| 字段中文名 | 例如：编号、设备编码 |
| 数据类型 | VARCHAR、NUMBER、DATE 等 |
| 长度 | 对应可变类型字段长度 |
| 小数位数 | 仅对 NUMBER 类型有效 |
| 是否主键 | 设置为主键字段 |
| 是否允许为空 | 设置该字段是否可为 null |
| 默认值 | 设置字段默认值 |
| 字段描述 | 补充字段用途或格式说明 |
字段列表支持：
- 【新增字段】：添加新字段；
- 【编辑】：修改字段配置；
- 【删除】：移除字段。
📷 [模型字段]：字段配置页面，展示字段列表及新增/编辑弹窗
6. 编辑逻辑模型
逻辑模型支持修改，包含两种模式：
6.1 手工录入模型编辑
适用于手工定义模型的修改场景。
可编辑内容：
- 模型中文名称、英文名称
- 模型描述
- 状态（启用 / 禁用）
- 联系人、联系方式
- 字段列表（可编辑字段属性，新增、删除字段）
字段支持修改：字段名、类型、长度、主键标识等。
📷 [编辑-手工录入] 编辑逻辑模型（手工录入）界面
6.2 物化表生成模型编辑
适用于通过物化数据库表生成的逻辑模型。
在手工基础上增加：
- 数据库连接信息展示（不可更改）
- 表来源信息保留
- 字段仍支持编辑、增删，便于二次修正
注意事项：
- 数据源和原始物理表不建议修改；
- 字段调整应谨慎，以避免与原表结构偏差过大。
📷 [编辑-物化表生成] 编辑逻辑模型（物化表生成）界面
编辑完成后，点击【确认】按钮保存，系统将更新逻辑模型定义信息。若模型已被引用，请谨慎更改字段结构。
7. 删除逻辑模型
在模型管理列表中，支持删除单个或批量逻辑模型。系统会校验模型是否已被引用或已物化生成，确保数据安全。
操作步骤：
- 在逻辑模型列表中勾选需要删除的模型，或点击某一行的【删除】按钮；
- 系统弹出确认提示框，需点击【确定】方可完成删除。
注意事项：
- 若逻辑模型已被引用（如用于数据物化或关联其他模型），系统将禁止删除；
- 删除操作不可恢复，请谨慎操作。
📷 [删除逻辑模型确认提示] 删除逻辑模型时的确认提示弹窗
8. 逻辑物化
逻辑模型支持一键物化为数据库中的实际物理表，简化数据建表流程，保障结构标准统一。
使用场景：
- 快速从标准逻辑模型生成物理表；
- 减少重复建表工作；
- 保证各系统间表结构一致性。
操作步骤：
- 进入某个逻辑模型详情页面；
- 点击【逻辑物化】标签页；
- 选择目标数据库连接、填写数据库类型；
- 点击【确认】，系统自动将该模型转化为对应数据库中的表结构。
📷 [逻辑模型物化弹窗] 逻辑模型物化弹窗界面
注意事项：
- 请确保已配置好数据库连接；
- 若目标库中已存在同名表，请先处理命名冲突；
- 物化后字段结构应避免随意调整，保持与逻辑模型一致。
物化成功后，可在数据库中查看该模型生成的真实表结构，并开始数据写入与使用。
删除完成后，列表将实时更新，已删除的模型将不再显示。
💬 附：常见问题 FAQ
Q：逻辑模型和数据库物理表的区别？
A：逻辑模型仅定义表结构，是模板和标准；物理表为实际存储数据的数据库对象，可基于逻辑模型物化生成。
Q：字段支持哪些数据类型？
A：支持常用关系型数据库字段类型，如 VARCHAR、NUMBER、DATE、BOOLEAN 等。
Q：逻辑模型是否支持查看物化记录？
A：支持，可在详情中中选择逻辑物化tab，即可查看物化记录。