# 数据建模相关问题排查指南

# 排查指南详细说明

通用前置检查：

确认版本：首先明确是 7.3 GA 还是 7.3.1 版本，不同版本的补丁不通用。
确认模块集成：检查平台参数配置中 DAM_BUILD_MODEL.IS_OPEN 是否为 Y，确保数据建模模块已开启。
查阅补丁列表：在寻求复杂解决方案前，强烈建议先检索是否有官方发布的补丁。您可以通过以下链接访问官方补丁列表：
- DAMP 7.3.1 补丁列表: DAMP7.3.1补丁列表 (opens new window)
- DAMP 7.3 GA 补丁列表: DAMP7.3GA补丁列表 (opens new window)

# 场景一：模型创建/编辑失败

问题现象：
1. 点击“新增概念模型”无反应或报错。
2. 模型保存时提示“操作数据异常”。
3. 双击表无法进入字段维护页面。
4. 基于数据源逆向生成模型失败。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 模型、新增、创建。
  - 相关补丁：
    - DAMP 7.3.1: DAMP_7.3.1_SERVER_20250218_P1 (解决数据系统修改名称后模型报错空指针)
    - DAMP 7.3.1: DAMP_7.3.1_SERVER_20251210_P1 (解决生产环境新建流程报主键冲突)
  - 解决方案：若找到描述匹配的补丁，则申请并应用。
2. 第二步：检查数据源配置。
  - 操作：确认系统已正确关联数据源。
  - 排查项：
    - 在“系统管理”中，该系统是否已关联数据源。
    - 关联的数据源是否已成功采集元数据。
    - 数据源连接测试是否通过。
  - 解决方案：
    - 如果未关联数据源，在系统管理中补充数据源。
    - 如果数据源连接失败，修正数据源配置后重试。
3. 第三步：检查达梦数据库配置。
  - 现象：点击项目数据源展开无子项，无法逆向生成模型。
  - 排查项：dm_db_vendor 表中配置错误。
  - 解决方案：
```
-- 检查数据库供应商配置
SELECT * FROM dm_db_vendor WHERE name LIKE '%dameng%';

-- 如果name列值为'dameng8'，修改为'dm'
UPDATE dm_db_vendor SET name = 'dm' WHERE name = 'dameng8';

-- 同时检查dm_db_type表
UPDATE dm_db_type SET name = 'dm' WHERE name = 'dameng';

-- 修改后重启服务
```
4. 第四步：检查词根配置。
  - 操作：如果通过中文名称自动生成英文名称失败。
  - 排查项：词根库中是否包含相关分词。
  - 解决方案：
    - 在“词根管理”中补充缺失的词根。
    - 词根匹配规则：先完全匹配，再分词匹配。

# 场景二：模型发布/流程异常

问题现象：
1. 模型提交后无反应，不进入流程。
2. 发布检核卡住，无法完成。
3. 模型变更失败，提示“系统状态不可变更”。
4. 发布后资产看不到模型。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 发布、提交、检核。
  - 相关补丁：
    - DAMP 7.3 GA: DAMP_7.3_SERVER_20240416_P1 (解决模型提交无提示问题)
    - DAMP 7.3 GA: DAMP_7.3_SERVER_20250508_P1 (解决模型核检定任务不能正常执行)
  - 解决方案：若找到描述匹配的补丁，则申请并应用。
2. 第二步：检查模型提交流程。
  - 现象：点击“模型提交”无反应。
  - 排查项：
    - 平台参数 DAM_BUILD_MODEL.IS_OPEN 是否设为 Y。
    - 流程定义是否已正确配置。
    - 模型是否已完成开发（所有必填项已填）。
  - 解决方案：
    - 确保平台参数配置正确，点击“刷新缓存”。
    - 在“工作流程-流程配置”中确认模型发布流程存在。
3. 第三步：处理发布检核卡住。
  - 现象：点击“发布检核”后，长时间无结果。
  - 排查项：
    - 检核规则配置是否正确。
    - 检核日志中是否有错误信息。
  - 解决方案：
    - 在“模型检核”页面点击“查看日志”，分析具体错误。
    - 如果检核规则过于严格，调整规则后重新检核。
    - 申请补丁 DAMP_7.3_SERVER_20250508_P1（解决定时任务不执行）。
4. 第四步：检查系统状态。
  - 现象：模型变更失败，提示“系统状态不可变更”。
  - 排查项：系统中是否有未完成的流程。
  - 解决方案：
    - 在“我的系统”列表中，检查该系统是否有进行中的流程。
    - 完成或终止所有未完成流程后，重新发起变更。

# 场景三：模型关系/关联异常

问题现象：
1. 逻辑实体关联物理表后，资产编目中不显示。
2. 实体间关系在IDE中配置后不生效。
3. 字段关联后丢失或显示不全。
4. 生成物理模型时关系未同步。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 关联、关系、物理表。
  - 相关补丁：
    - DAMP 7.3.1: DAMP_7.3.1_SERVER_20250218_P1 (解决关联后空指针)
  - 解决方案：若找到描述匹配的补丁，则申请并应用。
2. 第二步：处理逻辑实体关联物理表不显示。
  - 操作：资产编目时，逻辑实体关联的物理表不显示。
  - 排查项：
    - 逻辑模型是否已成功发布。
    - 物理表是否已通过元数据采集成功。
    - 在模型管理中是否已配置逻辑实体与物理实体的关联。
  - 解决方案：
    - 确保逻辑模型已发布。
    - 重新采集元数据，确保物理表存在。
    - 在逻辑模型IDE中，重新建立与物理实体的关联。
3. 第三步：处理IDE中关系配置不生效。
  - 现象：拖拽连线配置关系后，保存再打开关系丢失。
  - 排查项：
    - 浏览器兼容性问题。
    - 关系配置是否正确（如主外键关系）。
  - 解决方案：
    - 使用Chrome 80+或Edge 80+浏览器。
    - 清理浏览器缓存后重新配置。
    - 确保拖拽时从字段连接到字段，而不是从表连接到表。
4. 第四步：处理字段关联后丢失。
  - 现象：配置好的字段关联，再次打开时消失。
  - 排查项：字段属性完整性。
  - 解决方案：
    - 检查字段是否都有合法的数据类型和长度。
    - 重新导入或重新配置字段信息。
    - 申请补丁 DAMP_7.3.1_SERVER_20250313_P2。

# 场景四：模型导入/导出异常

问题现象：
1. 导入模型文件后，IDE中显示为空。
2. 导出excel时内容为空。
3. 模型文件下载失败。
4. 导入时报“文件解析错误”。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 导入、导出、模板。
  - 相关补丁：
    - DAMP 7.3 GA: DAMP_7.3_ALL_20250908_P1 (解决模型历史导出excel空数据、模型导出再导入为空)
    - DAMP 7.3 GA: DAMP_7.3_SERVER_20250901_P1 (解决逻辑实体关联关系导出不体现)
  - 解决方案：若找到描述匹配的补丁，则申请并应用。
2. 第二步：处理导入后模型为空。
  - 现象：导入模型文件后，IDE中看不到任何实体。
  - 排查项：
    - 模板格式是否正确。
    - 文件大小是否超过限制。
    - 导入模型配置中的实体数量限制。
  - 解决方案：
    - 确认使用官方提供的导入模板。
    - 在“导入模型配置”中调整最大实体数量。
    - 检查nginx文件上传大小限制。
3. 第三步：处理导出excel无数据。
  - 现象：点击导出，下载的excel文件内容为空。
  - 排查项：
    - 数据库驱动问题（特别是达梦数据库）。
    - 是否有权限导出数据。
  - 解决方案：
    - 更换达梦数据库驱动。
    - 申请补丁 DAMP_7.3_ALL_20250908_P1。
    - 在JDBC URL中添加 ?columnNameUpperCase=false。
4. 第四步：处理模型关系导出不体现。
  - 现象：逻辑实体之间有关联关系，但导出excel中没有体现。
  - 排查项：导出功能是否包含关系数据。
  - 解决方案：
    - 申请补丁 DAMP_7.3_SERVER_20250901_P1。
    - 升级到7.3.1版本。

# 场景五：模型检核/定时任务异常

问题现象：
1. 模型检核定任务不执行。
2. 检核结果异常或报错。
3. 定时任务日志报错。
4. 任务状态一直为“执行中”。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 检核、定时任务。
  - 相关补丁：
    - DAMP 7.3 GA: DAMP_7.3_SERVER_20250508_P1 (解决模型核检定任务不能正常执行)
  - 解决方案：若找到描述匹配的补丁，则申请并应用。
2. 第二步：检查定时任务配置。
  - 操作：进入“模型检核定时任务”页面，检查任务配置。
  - 排查项：
    - cron表达式是否正确。
    - 任务状态是否为“启用”。
    - 开始时间、结束时间是否合理。
  - 解决方案：
    - 修正cron表达式。
    - 启用被禁用的任务。
    - 调整任务时间范围。
3. 第三步：检查检核规则配置。
  - 操作：进入“检核规则配置”页面，检查规则状态。
  - 排查项：
    - 内置规则是否被错误关闭。
    - 自定义规则配置是否正确。
    - 规则预览是否符合预期。
  - 解决方案：
    - 开启需要的内置规则。
    - 调整自定义规则参数。
    - 在测试系统验证规则后再应用到生产。
4. 第四步：查看检核日志。
  - 操作：点击“执行日志”，查看任务执行详情。
  - 排查项：日志中的具体错误信息。
  - 解决方案：
    - 根据错误信息修复问题。
    - 如果日志显示SQL错误，检查数据库兼容性。
    - 申请补丁 DAMP_7.3_SERVER_20250508_P1。

# 场景六：模型开发IDE问题

问题现象：
1. IDE页面加载缓慢或卡死。
2. 无法拖拽实体或连线。
3. 点击数据源无子项展开。
4. 字段列表显示不全。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 IDE、拖拽、建模。
  - 相关补丁：
    - DAMP 7.3.1: DAMP_7.3.1_UI_20251231_P1 (解决物理模型列无法拖动、逻辑模型列看不到列表内容)
  - 解决方案：若找到描述匹配的补丁，则申请并应用。
2. 第二步：检查浏览器兼容性。
  - 操作：确认浏览器版本符合要求。
  - 要求：
    - Chrome ≥ 80
    - Edge ≥ 80
    - FireFox ≥ 74
    - 不支持IE（需要单独介质）
  - 解决方案：
    - 升级浏览器到最新版本。
    - 清理浏览器缓存和Cookie。
    - 切换Chrome内核浏览器。
3. 第三步：处理模型实体过多问题。
  - 现象：模型实体超过50个时，IDE加载缓慢。
  - 排查项：单次加载的实体数量。
  - 解决方案：
    - 在“导入模型配置”中调整单次导入的最大实体数量（建议≤200）。
    - 拆分大模型为多个小模型。
    - 分批进行模型开发。
4. 第四步：处理数据源无子项问题。
  - 现象：点击数据源节点，无法展开看到表。
  - 排查项：达梦数据库配置。
  - 解决方案：
```
-- 检查并修正数据库供应商配置
UPDATE dm_db_vendor SET name = 'dm' WHERE name = 'dameng8';
UPDATE dm_db_type SET name = 'dm' WHERE name = 'dameng';

-- 重启服务后重试
```
5. 第五步：处理字段列表显示不全。
  - 现象：字段名称过长时只显示前几个字。
  - 排查项：UI样式问题。
  - 解决方案：
    - 申请补丁 DAMP_7.5.0_UI_20251231_P1（7.5版本补丁，7.3版本可参考）。
    - 调整浏览器分辨率或缩放比例。
    - 手动拖动列宽。

← 数据服务统计监控相关问题数据资产编目问题 →