普元数据资产管理平台
运维指南

# 数据资产与数据质量对接相关功能排查指南（7.5版本）

# 排查指南详细说明

通用前置检查：

  • 确认版本：明确是7.5.0版本。
  • 确认质量模块集成：检查平台参数 DAM_BUILD_QUALITY.IS_OPEN 是否设置为 Y。
  • 确认数据源配置：质量模块使用的数据源名称需与DAMP中一致，参数 DAM_BUILD_QUALITY.dataSourceName 配置正确。
  • 查阅补丁列表：优先检索官方补丁。您可以通过以下链接访问官方补丁列表：

# 场景一：标准规则生成异常

  • 高频现象：

    1. 通过数据元标准无法正常生成质量检核规则，规则名称为null。
    2. 数据元标准生成的参考数据自定义检核规则运行失败，检核规则为空。
    3. 变更发布状态的数据元标准生成的规则，规则信息中参考数据检核后为undefined。

  • 排查步骤：

    1. 第一步：排除产品BUG。

      • 操作：在官方补丁列表中，搜索关键词 检核规则、规则名称、null。
      • 相关补丁示例：
        • DAMP_7.5.0_SERVER_20251121_P1（解决质量检核规则名称为null）
        • DAMP_7.5.0_SERVER_20250918_P2（解决数据元完整性检查失败）
        • DAMP_7.5.0_UI_20251128_P1（解决参考数据检核后为undefined）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查质量开关配置。

      • 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
      • 排查项：DAM_BUILD_QUALITY.IS_OPEN 参数是否设置为 Y。
      • 解决方案：如果设置为 N，修改为 Y 后点击“刷新缓存”。

    3. 第三步：检查数据元规则配置。

      • 操作：进入数据元标准编辑页面，检查“规则信息”页签。
      • 排查项：
        • 是否已点击“生成检核规则”完成规则配置。
        • 规则类型选择是否正确（数据内容检核/基于已有质量规则）。
        • 检核规则是否已正确选择。
      • 解决方案：
        • 重新生成检核规则。
        • 确保规则配置完整后重新提交标准发布。

    4. 第四步：确认标准已关联元数据。

      • 操作：检查数据元标准是否已关联技术元数据。
      • 排查项：标准发布成功后，是否执行了“添加关联”操作，关联了技术元数据。
      • 解决方案：在标准列表页，点击操作栏中的“添加关联”，关联技术元数据。关联成功后，规则会自动推送到数据质量平台。

# 场景二：质量规则执行/监控异常

  • 高频现象：

    1. 标准规则监控页面无规则执行记录。
    2. 质量规则执行失败，无日志。
    3. 规则一直处于“处理中”状态。
    4. 数据质量在检核Oracle数据库时读取超时。

  • 排查步骤：

    1. 第一步：排除产品BUG。

      • 操作：在官方补丁列表中，搜索关键词 规则监控、执行失败、超时。
      • 相关补丁示例：
        • DAMP_7.5.0_SERVER_20250903_P1 + QUALITYCUBE_7.3.0_SERVER_20250903_P1（解决标准落标统计无数据）
        • DAMP_7.5.0_SERVER_20251112_P1（解决核检规则监控只显示规则标准和映射标准）
        • QUALITYCUBE_7.3.0_ALL_20250919_P1（解决Oracle读取超时问题）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查质量模块状态。

      • 操作：确认数据质量模块服务是否正常启动。
      • 命令：ps -ef | grep quality，检查质量服务进程。
      • 解决方案：如果服务未启动，启动数据质量服务。

    3. 第三步：检查规则执行日志。

      • 操作：在“标准规则监控”页面，点击“详情”查看规则执行日志。
      • 排查项：日志中的具体错误信息。
      • 解决方案：
        • 如果日志显示SQL错误，检查SQL语法兼容性。
        • 如果日志显示连接超时，检查网络和防火墙设置。
        • 如果日志显示权限不足，检查数据库用户权限。

    4. 第四步：处理“Oracle读取超时”问题。

      • 现象：检核Oracle数据库时，SQL执行约15秒，但后台很快报读取超时。
      • 排查项：数据源URL中未正确配置读取超时参数。
      • 解决方案：
        • 申请补丁 QUALITYCUBE_7.3.0_ALL_20250919_P1。
        • 在数据源URL中添加读取超时参数，例如：oracle.jdbc.ReadTimeout=60000

    5. 第五步：手动触发规则执行。

      • 操作：在“标准规则监控”页面，找到对应的规则，点击“立即执行”。
      • 排查项：执行后是否有新的日志产生。
      • 解决方案：如果规则一直处于“处理中”状态，点击“状态重置”后重新执行。

# 场景三：落标统计结果异常

  • 高频现象：

    1. 标准落标统计查看结果无数据。
    2. 落标统计结果与质量模块实际执行结果不一致。
    3. 点击“查看结果”报错或页面空白。

  • 排查步骤：

    1. 第一步：排除产品BUG。

      • 操作：在官方补丁列表中，搜索关键词 落标统计、查看结果、无数据。
      • 相关补丁示例：
        • DAMP_7.5.0_SERVER_20250903_P1 + QUALITYCUBE_7.3.0_SERVER_20250903_P1（解决标准落标统计无数据）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查落标统计配置。

      • 操作：确认标准已关联技术元数据，且质量规则已成功生成。
      • 排查项：
        • 数据元标准中规则状态是否为“已生效”。
        • 关联的技术元数据是否存在且已采集。
      • 解决方案：补全关联关系后，重新执行落标统计。

    3. 第三步：检查质量结果数据。

      • 操作：进入数据质量模块，确认质量规则执行结果是否存在。
      • 排查项：质量模块中是否有对应的执行记录和问题数据。
      • 解决方案：如果质量模块无数据，按场景二排查规则执行问题。

    4. 第四步：手动触发重新统计。

      • 操作：在“系统落标统计”页面，点击“重新统计”按钮。
      • 排查项：重新统计后数据是否更新。
      • 解决方案：如果仍无数据，检查定时任务配置：damp.standard.summary.time

# 场景四：数据源/质量模块集成问题

  • 高频现象：

    1. 数据元标准中“基于已有质量规则”查询不到质量规则。
    2. 质量规则关联时分页不生效。
    3. 质量模块中数据源同步失败。

  • 排查步骤：

    1. 第一步：排除产品BUG。

      • 操作：在官方补丁列表中，搜索关键词 关联、分页、同步。
      • 相关补丁示例：
        • DAMP_7.5.0_SERVER_20250911_P1（解决质量规则查询分页错误）
        • QUALITYCUBE_7.3.0_SERVER_20250820_P1（解决同步数据源页面报JSON错误）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查集成开关配置。

      • 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
      • 排查项：DAM_BUILD_QUALITY.IS_OPEN 参数是否设置为 Y。
      • 解决方案：如果设置为 N，修改为 Y 后点击“刷新缓存”。

    3. 第三步：检查数据源名称一致性。

      • 操作：检查平台参数 DAM_BUILD_QUALITY.dataSourceName 配置。
      • 排查项：该名称需要与数据质量模块中配置的数据源名称完全一致。
      • 解决方案：修正为正确的数据源名称后重启服务。

    4. 第四步：检查质量模块数据源状态。

      • 操作：登录数据质量模块，确认数据源存在且连接正常。
      • 排查项：数据源是否已配置，连接测试是否通过。
      • 解决方案：在质量模块中配置数据源，确保与DAMP中名称一致。

# 场景五：质量规则关联/同步问题

  • 高频现象：

    1. 数据元标准关联已有质量规则时，查询不到规则。
    2. 关联规则后，规则未在标准监控中显示。
    3. 规则同步失败。

  • 排查步骤：

    1. 第一步：排除产品BUG。

      • 操作：在官方补丁列表中，搜索关键词 关联、同步、查询不到。
      • 相关补丁示例：
        • DAMP_7.5.0_SERVER_20250911_P1（解决质量规则查询分页错误）
        • DAMP_7.5.0_SERVER_20251112_C1（解决数据元关联质量规则bug）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查关联配置。

      • 操作：在数据元标准编辑页面，进入“规则信息”页签。
      • 排查项：规则类型是否选择为“基于已有质量规则”。
      • 解决方案：选择正确的规则类型后重新关联。

    3. 第三步：检查分页参数。

      • 操作：如果规则列表能显示但查询不到目标规则，检查分页。
      • 排查项：是否当前页未显示，尝试翻页或调整每页显示条数。
      • 解决方案：申请补丁 DAMP_7.5.0_SERVER_20250911_P1 修复分页问题。

    4. 第四步：检查规则状态。

      • 操作：进入数据质量模块，确认目标规则是否存在且已发布。
      • 排查项：规则是否被删除或作废。
      • 解决方案：在质量模块中重新创建或发布规则。
上次更新: 2026/3/19下午1:30:01

← 数据资产流程相关问题排查指南 →