普元数据资产管理平台

# 数据资产编目问题排查指南

# 排查指南详细说明

通用前置检查：

# 场景一：资产提交/发布失败
  • 问题现象：
    1. 点击“提交”后无响应或报错。
    2. 流程无法发起，后台日志报SQL异常（如主键冲突 Duplicate entry）。
    3. 基于逻辑实体编目无法提交。
  • 排查步骤：
    1. 第一步：排除产品BUG。
      • 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 提交、发布、流程。
      • 相关补丁（示例）：
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20250611_P2 (解决资产发布流程中获取不到字段属性详情)
        • DAMP 7.3 GA: DAMP_7.3_SERVER_20240416_P1 (解决模型提交无提示问题)
      • 解决方案：若找到描述匹配的补丁，则申请并应用。
    2. 第二步：检查数据完整性。
      • 操作：核对资产编目表单中的必填项。
      • 排查项：
        • 主管部门：确认“主管部门”字段不为空。该字段通常根据“所属应用系统”自动带出，若为空，需检查系统管理中该系统是否已正确关联部门。
        • 所属应用系统：确认所选系统存在且当前用户有权限。
      • 解决方案：补充或修正相关数据后，重新提交。
    3. 第三步：检查关联数据合法性。
      • 操作：检查逻辑实体或元数据的状态。
      • 排查项：如果基于逻辑实体编目，确认该逻辑实体已经成功发布。未发布的逻辑实体无法被用于编目提交。
      • 解决方案：先完成逻辑实体的发布流程，再重新进行资产编目。
    4. 第四步：数据库层问题排查。
      • 操作：分析后台日志的具体报错。
      • 排查项：
        • 若报错 Duplicate entry '...' for key 'PRIMARY'：通常是网络波动时用户重复点击提交导致，在流程相关表（如 bfp_process_opinions）中可能存在脏数据。
        • 解决方案：清理脏数据或忽略后重新发起新流程即可。
        • 若报错 事务回滚 且涉及 rcm_operation_log 表：可能是该表的 BUS_ID 字段长度不足以存储生成的业务ID。
        • 解决方案：根据数据库类型修改该字段长度（如改为TEXT或VARCHAR(255)）。
# 场景二：资产导出/导入异常
  • 问题现象：
    1. 导出的Excel内容是空的。
    2. 导入Excel报错（如 NumberFormatException， 资产模板错误）。
    3. 导入后数据不正确（如只有一条信息项）。
  • 排查步骤：
    1. 第一步：排除产品BUG。
      • 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 导出、导入、模板、英文名称。
      • 相关补丁（示例）：
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20250418_P1 (解决资产英文名称导出丢失、安全等级数据不正确)
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20250509_P1 (解决Oracle数据库适配及导出问题)
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20260203_P1 (解决标准分域自定义字段导出后没有数据)
        • DAMP 7.3 GA: DAMP_7.3_ALL_20250908_P1 (解决模型历史导出excel空数据)
        • DAMP 7.3 GA: DAMP_7.3_SERVER_20240419_P1 (解决数据元标准使用模板导入一直报错)
      • 解决方案：若找到描述匹配的补丁，则申请并应用。
    2. 第二步：检查数据库驱动（达梦数据库特有）。
      • 操作：检查DAMP服务所使用的达梦数据库驱动版本。
      • 排查项：使用了错误的或旧版的达梦驱动（DmJdbcDriver18.jar）。
      • 解决方案：
        1. 更换为官方推荐的最新版驱动。
        2. 在数据源配置的JDBC URL中，显式添加参数 ?columnNameUpperCase=false 和 ?schema=用户名（例如：jdbc:dm://127.0.0.1:5236?schema=QUALITY&columnNameUpperCase=false）。
    3. 第三步：检查导入模板。
      • 操作：核对使用的Excel模板是否为最新版本。
      • 排查项：
        • 模板文件本身是否损坏。
        • Excel单元格格式是否正确（例如，ID列不应被Excel自动格式化为日期或科学计数法）。
        • 必填列是否有空值。
      • 解决方案：在资产编目页面重新下载最新模板，将数据以纯文本格式粘贴进去，重新上传。
    4. 第四步：检查导入数据逻辑（针对特定场景）。
      • 现象：基于逻辑实体编制，导入成功后信息项缺失。
      • 排查项：检查Excel模板中“资产编号”列的填写规则。如果是基于同一逻辑实体的多个信息项（字段）导入，这些信息项的“资产编号”必须保持一致。
      • 解决方案：修正模板中信息项的资产编号，确保它们是同一个资产的不同属性。
# 场景三：资产字段/属性显示不全或丢失
  • 问题现象：
    1. 资产详情页或编目预览中，部分字段不显示。
    2. 资产关联的分类信息丢失。
    3. 资产英文名称为空。
    4. 界面显示异常（如下划线消失、html标签暴露）。
  • 排查步骤：
    1. 第一步：排除产品BUG。
      • 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 显示、丢失、详情、html、下划线。
      • 相关补丁（示例）：
        • DAMP 7.3.1: DAMP_7.3.1_UI_20250908_P1 (解决资产相关性显示不全)
        • DAMP 7.3.1: DAMP_7.3.1_UI_20250613_P1 (解决资产发布流程中下划线消失)
        • DAMP 7.3.1: DAMP_7.3.1_UI_20250418_P1 (解决资产浏览分词搜索后高亮字变成html标签)
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20250611_P2 (解决资产发布流程中获取不到字段属性详情)
        • DAMP 7.3 GA: DAMP_7.3_UI_20240126_P1 (解决物理模型打开字段编辑抽屉，字段不显示)
      • 解决方案：若找到描述匹配的补丁，则申请并应用。
    2. 第二步：清理服务缓存。
      • 操作：当属性项在F12调试中能看到数据返回，但页面不显示时。
      • 排查项：DAMP服务端缓存的视图文件损坏或未更新。
      • 解决方案：
        1. 停止DAMP服务。
        2. 删除DAMP安装目录下的 /config/DAMP/work/ 文件夹下的所有内容（该文件夹存储了缓存的视图配置）。
        3. 重新启动DAMP服务。系统会自动重新生成这些文件。
    3. 第三步：检查数据层级关系。
      • 操作：如果资产关联的分类不显示。
      • 排查项：在“资产分类管理”中，检查该分类的“层级数据”（如 group_id, group_level）是否正确。错误的层级（例如，将非叶子节点关联给了资产）会导致页面无法正常加载。
      • 解决方案：在数据库层面修正分类表（如 rcm_group）中的层级字段，或删除错误的关联关系后重新关联。
    4. 第四步：检查元数据服务状态。
      • 操作：如果资产是基于元数据编目的，且元数据相关属性（如字段类型、注释）不显示。
      • 排查项：在“平台参数配置”中，检查 metacube.serverUrl 配置的地址是否正确，并且DAMP服务能正常访问该地址。元数据服务停止会导致资产无法获取元数据详情。
      • 解决方案：修正 metacube.serverUrl 地址，或重启元数据服务（Metacube/DGS）。
# 场景四：流程卡住或状态不对
  • 问题现象：
    1. 资产提交后，流程长时间处于“审核中”。
    2. 流程被回退或终止后，资产状态仍是“变更中”。
    3. 审批人收不到待办任务。
  • 排查步骤：
    1. 第一步：检查流程配置。
      • 操作：管理员登录后，进入“工作流程” -> “业务配置” -> “流程配置”。
      • 排查项：找到对应的资产流程（如资产发布流程、变更流程），检查其版本和定义是否正常。
      • 现象：资产变更流程回退并终止后，状态卡在“变更中”。
      • 解决方案：在“流程配置”中，找到该流程的“发起人”环节，将其“终止操作”从默认值改为 “保存数据”。这样当流程在发起人环节被终止时，系统会保存当前变更的数据并将资产状态回滚。
    2. 第二步：检查业务数据问题。
      • 操作：检查流程相关的业务表。
      • 排查项：如果流程因主键冲突报错，检查BPS相关表（如 eos_unique_table）中的ID生成策略。若 ProcessDefPropertiesID 的 CODE 值过小，可能在ID达到上限后无法生成新ID。
      • 解决方案：在 eos_unique_table 表中，找到 NAME 为 ProcessDefPropertiesID 的记录，将其 CODE 值手动调大（例如在原值基础上增加20），然后重启BPS服务。
    3. 第三步：检查人员权限。
      • 操作：确认审批人是否拥有正确的角色。
      • 排查项：
        • 资产申请流程：需要“业务部门审批人”（通常是资产所属部门的部门管理员）和“数据部门审批人”（通常是dtadmin）。
        • 确认审批人账号的角色列表中，有对应的“资产部门管理员”或“资产管理员”角色。
      • 解决方案：由租户管理员（admin）登录，在“组织管理”中为审批人账号授予相应的角色。
上次更新: 2026/3/12下午1:52:20

← 数据资产部署至达梦数据库环境相关问题 →