普元数据资产管理平台

# 数据标准管理问题排查指南

# 排查指南详细说明

# 通用前置检查：

# 场景一：标准导入异常

  • 问题现象：
    • 上传模板后提示“资产模板错误，请下载正确模板重新导入”。
    • 标准导入时报错，后台提示表不存在或字段不存在。
    • 导入过程中卡顿、中断，或提示“导入失败”无具体原因。
    • 导入后部分数据缺失、重复或格式错乱。
  • 排查步骤：
    • 第一步：排除产品BUG。
      1. 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 导入、模板、自定义字段。
      2. 相关补丁：
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20240731_P2 (解决标准导入报错、代码标准自定义字段问题)
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20250509_P1 (解决标准导出自定义字段为空、导出无响应、Oracle GROUP BY错误)
        • DAMP 7.3 GA: DAMP_7.3_ALL_20240520_P2 (解决达梦数据库导入标准归口管理部门为空)
      3. 解决方案：若找到描述匹配的补丁，则申请并应用。
    • 第二步：检查数据库驱动（达梦数据库特有）。
      1. 操作：检查DAMP服务所使用的达梦数据库驱动版本。
      2. 排查项：使用了错误的或旧版的达梦驱动，或者未配置大小写敏感参数。
      3. 解决方案：
        • 更换为官方推荐的最新版驱动。
        • 在数据源配置的JDBC URL中，显式添加参数 ?columnNameUpperCase=false（例如：jdbc:dm://127.0.0.1:5236?schema=QUALITY&columnNameUpperCase=false）。
    • 第三步：检查分类层级数据。
      1. 操作：当导入报错且与分类相关时，检查数据库表 rcm_standard_group。
      2. 排查项：GROUP_LEVEL 和 GROUP_SEQ 字段的值是否正确。错误的层级（如非数字值）会导致导入时无法定位分类。
      3. 解决方案： -- 检查分类数据 ``SELECT id, group_name, group_level, group_seq FROM rcm_standard_group WHERE group_level IS NULL OR group_level = ''; ``-- 修正层级为数字结构 ``UPDATE rcm_standard_group SET group_level = '1' WHERE id = 'xxx' AND (group_level IS NULL OR group_level = '');
    • 第四步：检查导入模板。
      1. 操作：核对使用的Excel模板是否为最新版本。
      2. 排查项：
        • 模板文件是否从当前系统下载。
        • Excel单元格格式是否正确（日期、数字列不应被自动格式化）。
        • 必填字段是否填写完整。
        • 分类列填写的分类名称是否与系统内完全一致。
      3. 解决方案：在标准管理页面重新下载最新模板，将数据以纯文本格式粘贴进去，重新上传。
    • 第五步：检查数据内容格式。
      1. 操作：针对具体的错误提示进行检查。
      2. 排查项：
        • 若报错 NumberFormatException：检查Excel中数字格式的列是否包含非数字字符。
        • 若报错 ORA-00979: not a GROUP BY expression（Oracle数据库）：申请补丁 DAMP_7.3.1_SERVER_20250509_P1。
      3. 解决方案：修正Excel中的数据格式后重新导入。

# 场景二：标准导出异常

  • 问题现象：

    • 导出的Excel内容是空的或部分字段缺失。
    • 导出按钮无响应或点击后报错。
    • 导出文件无法打开、提示“文件损坏”。
    • 导出数据与系统显示数据不一致（如排序错乱、筛选条件不生效）。

  • 排查步骤：

    • 第一步：排除产品BUG。

      1. 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 导出、Excel、自定义字段。
      2. 相关补丁：
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20250509_P1 (解决标准导出自定义字段为空、导出无响应、Oracle GROUP BY错误)
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20250418_P1 (解决资产英文名称导出为空)
      3. 解决方案：若找到描述匹配的补丁，则申请并应用。

    • 第二步：检查数据库驱动与环境。

      1. 操作：检查DAMP服务所使用的数据库驱动版本及环境配置。
      2. 排查项：
        • 达梦数据库：使用旧版驱动或未配置大小写敏感参数，导致字段查询异常。
        • Oracle数据库：SQL语法兼容性问题（如GROUP BY子句格式错误），导致导出数据查询失败。
      3. 解决方案：
        • 达梦数据库：更换官方推荐的最新版驱动，在JDBC URL中添加 ?columnNameUpperCase=false 参数。
        • Oracle数据库：申请补丁 DAMP_7.3.1_SERVER_20250509_P1，或检查SQL语句兼容性并修正。

    • 第三步：检查数据完整性。

      1. 操作：检查系统中标准数据及关联数据是否完整。

      2. 排查项：

        • 标准数据存在空值、异常字符，导致导出时解析失败。
        • 分类层级数据异常（rcm_standard_group 表 GROUP_LEVEL/GROUP_SEQ 字段错误），导致导出筛选异常。

      3. 解决方案：

        -- 检查分类数据完整性 ``SELECT id, group_name, group_level, group_seq FROM rcm_standard_group WHERE group_level IS NULL OR group_level = ''; ``-- 修正层级为数字结构 ``UPDATE rcm_standard_group SET group_level = '1' WHERE id = 'xxx' AND (group_level IS NULL OR group_level = ''); ``-- 检查标准数据空值 ``SELECT id, standard_name FROM rcm_standard WHERE standard_name IS NULL OR standard_name = '';修正异常数据后重新导出。

    • 第四步：检查文件解析与存储。

      1. 操作：当导出文件损坏或无法打开时，检查文件生成及存储情况。
      2. 排查项：
        • 服务器存储空间不足，导致导出文件生成不完整。
        • Excel版本兼容问题（如导出为高版本格式，低版本Excel无法打开）。
      3. 解决方案：
        • 检查服务器存储空间，清理冗余文件释放空间后重新导出。
        • 使用高版本Excel（2016及以上）打开文件，或联系技术人员调整导出文件格式。

# 场景三：标准分类/分组异常

  • 问题现象：
    • 分类树显示异常，无法在正确节点下创建标准。
    • 分类名称修改后，关联的分类名称未同步更新。
    • 分类无法删除，提示“操作数据异常”。
    • 点击标准分类选择时浏览器崩溃。
  • 排查步骤：
    • 第一步：排除产品BUG。
      1. 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 分类、分组、GROUP_SQL_NAME。
      2. 相关补丁：
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20250313_P2 (解决分类名称修改后GROUP_SQL_NAME未同步)
      3. 解决方案：若找到描述匹配的补丁，则申请并应用。
    • 第二步：检查分类表层级数据。
      1. 操作：检查 rcm_standard_group 表中的关键字段。
      2. 排查项：
        • GROUP_LEVEL：层级值是否正确（根节点为1，子节点依次递增）。
        • PARENT_ID：父子关系是否正确建立。
        • IS_LEAF：叶子节点标识是否正确（1为叶子节点，0为非叶子节点）。
        • GROUP_SEQ：路径编码是否正确（如 001.002.003）。
      3. 解决方案： -- 检查并修正分类层级 ``-- 修正根节点层级 ``UPDATE rcm_standard_group SET group_level = 1 WHERE parent_id IS NULL AND (group_level IS NULL OR group_level = ''); ``-- 修正子节点层级 ``UPDATE rcm_standard_group child, rcm_standard_group parent ``SET child.group_level = parent.group_level + 1 ``WHERE child.parent_id = parent.id AND (child.group_level IS NULL OR child.group_level = ''); ``-- 设置叶子节点标识 ``UPDATE rcm_standard_group SET is_leaf = 1 WHERE id NOT IN (SELECT DISTINCT parent_id FROM rcm_standard_group WHERE parent_id IS NOT NULL);
    • 第三步：检查分类删除约束。
      1. 操作：当删除分类失败时，检查引用关系。
      2. 排查项：
        • 该分类下是否仍有子分类。
        • 该分类下是否仍有标准（在 rcm_standard 表中引用该 group_id）。
      3. 解决方案： -- 查找引用该分类的标准 ``SELECT COUNT(*) FROM rcm_standard WHERE group_id = '待删除分类ID'; ``-- 先删除或移动这些标准到其他分类，再删除分类
    • 第四步：检查浏览器兼容性。
      1. 操作：如果选择分类时浏览器崩溃。
      2. 排查项：该问题无法复现，可能为环境特定问题。
      3. 解决方案：
        • 清理浏览器缓存。
        • 更换Chrome 80+或Edge 80+版本浏览器。
        • 检查分类数据量是否过大导致页面卡死。

# 场景四：标准关联/推荐异常

  • 问题现象：
    • 标准关联逻辑实体后，关联数量统计不准确。
    • 标准关联后，页面不显示关联的内容。
    • 标准推荐页面无数据或匹配不准确。
  • 排查步骤：
    • 第一步：排除产品BUG。
      1. 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 关联、推荐。
      2. 相关补丁：
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20241025_P1 (解决标准名称重复导致导入挂接目录混乱)
      3. 解决方案：若找到描述匹配的补丁，则申请并应用。
    • 第二步：检查标准发布状态。
      1. 操作：确认标准是否已发布。
      2. 排查项：只有“已发布”状态的标准才能被关联和推荐。
      3. 解决方案：完成标准的发布流程，待状态变为“已发布”后再进行关联操作。
    • 第三步：检查关联目标状态。
      1. 操作：确认要关联的目标（逻辑实体、技术元数据）是否存在且可用。
      2. 排查项：
        • 逻辑实体是否已发布。
        • 技术元数据是否已采集成功。
      3. 解决方案：确保关联目标状态正常后，重新关联。
    • 第四步：理解7.3.1版本关联特性。
      1. 操作：当发现关联数量比预期多时。
      2. 排查项：7.3.1版本中，标准关联逻辑实体时，若该逻辑实体已发布为资产，会自动建立标准与资产的关联。
      3. 解决方案：这是产品设计特性，关联数量统计包含标准关联的所有资源类型（逻辑实体+资产），无需处理。
    • 第五步：手动触发标准推荐。
      1. 操作：当标准推荐页面无数据时。
      2. 排查项：标准推荐定时任务是否执行。
      3. 解决方案：
        • 进入“平台配置” -> “系统工具”。
        • 找到“执行标准推荐”工具，点击“执行”。
        • 等待执行完成后，刷新标准推荐页面查看结果。

# 场景五：标准流程/状态异常

  • 问题现象：
    • 标准发布后状态仍为“审核中”。
    • 标准作废后，状态未变更为“已作废”。
    • 标准作废后，修订记录中无作废记录。
    • 标准批量提交时报事务回滚。
  • 排查步骤：
    • 第一步：排除产品BUG。
      1. 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 流程、审核中、作废。
      2. 相关补丁：
        • DAMP 7.3.1: DAMP_7.3.1_UI_20250630_P1 (解决标准分域字段配置后内容丢失)
      3. 解决方案：若找到描述匹配的补丁，则申请并应用。
    • 第二步：检查流程脏数据。
      1. 操作：当标准发布后状态未更新时。
      2. 排查项：BPS流程相关表可能存在脏数据。
      3. 解决方案：-- 备份相关表 ``CREATE TABLE bfp_process_opinions_bak_yyyymmdd AS SELECT * FROM bfp_process_opinions; ``-- 清理流程意见表中的脏数据（谨慎操作，建议先确认具体记录） ``-- DELETE FROM bfp_process_opinions WHERE process_id = '具体流程ID';
    • 第三步：检查项目定制逻辑。
      1. 操作：如果标准状态持续异常，且项目有二次开发。
      2. 排查项：项目是否定制过标准实体，导致SPI接口修改数据时类型不匹配。
      3. 解决方案：项目团队自行检查定制代码，修改SPI接口实现逻辑，确保状态更新正确。
    • 第四步：理解7.3GA版本作废特性。
      1. 操作：如果7.3GA版本中标准作废后修订记录不显示。
      2. 排查项：7.3_GA_1050版本中，作废操作是逻辑删除，发版时未包含在数据上加操作内容的功能。
      3. 解决方案：
        • 这是当前版本限制，后续版本会考虑支持。
        • 如果需要该功能，考虑升级到7.3.1版本。
    • 第五步：检查表结构限制。
      1. 操作：如果批量提交报事务回滚。
      2. 排查项：rcm_operation_log 表的 BUS_ID 字段长度可能不足。
      3. 解决方案： -- 修改表结构，增加BUS_ID字段长度 ``ALTER TABLE rcm_operation_log MODIFY BUS_ID VARCHAR(1000); ``-- 或改为TEXT类型 ``ALTER TABLE rcm_operation_log MODIFY BUS_ID TEXT;

# 场景六：标准监控/规则问题

  • 问题现象：
    • 标准规则监控页面无规则执行记录。
    • 系统落标统计页面查看结果报错。
    • 通过数据元标准无法正常生成质量检核规则。
  • 排查步骤：
    • 第一步：排除产品BUG。
      1. 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 监控、落标、规则。
      2. 相关补丁：
        • DAMP 7.3.1: DAMP_7.3.1_SERVER_20260203_P1 (解决标准分域自定义字段导出后没有数据)
      3. 解决方案：若找到描述匹配的补丁，则申请并应用。
    • 第二步：确认质量模块集成状态。
      1. 操作：检查是否已集成数据质量模块。
      2. 排查项：标准监控功能依赖数据质量模块，未集成时无法使用。
      3. 解决方案：如需使用标准监控功能，需部署并集成数据质量模块。
    • 第三步：检查规则生成配置。
      1. 操作：当标准无法生成质量规则时。
      2. 排查项：
        • 数据元标准中“规则信息”节点是否已配置。
        • 数据元质量开关是否开启。
        • 标准是否已关联技术元数据。
      3. 解决方案：
        • 在数据元新增/编辑页面，点击“新增检核规则”完成规则配置。
        • 标准发布成功后，执行“添加关联”操作，关联技术元数据。
        • 关联成功后，规则会自动推送到数据质量平台。
    • 第四步：手动触发规则执行。
      1. 操作：当规则已生成但无执行记录时。
      2. 排查项：规则可能处于就绪状态，等待调度执行。
      3. 解决方案：
        • 进入“标准规则监控”页面。
        • 找到对应的规则，点击“立即执行”。
        • 在“详情”中查看执行日志和结果。
    • 第五步：检查落标统计的数据源。
      1. 操作：当系统落标统计页面查看结果报错时。
      2. 排查项：该系统下的数据源是否已被采集，是否有数据元信息存在。
      3. 解决方案：
        • 确认该系统已配置数据源并成功采集元数据。
        • 确认数据元标准已与该系统的技术元数据建立关联。
        • 在“系统落标统计”页面点击“重新统计”刷新结果。
上次更新: 2026/3/12下午1:52:20

← 数据服务接口开发问题 →