数据质量任务

千桐科技2025/8/27大约 11 分钟用户手册

功能概览

功能定位

数据质量任务用于创建、配置和执行数据质量评测任务。用户在任务中选择稽查对象，并为对象配置对应的稽查规则，任务执行后会生成质量报告，供后续查看评分、执行记录、运行日志和问题数据。

简单理解：数据质量任务是数据质量评测的配置入口，决定评测对象、评测规则、执行方式和责任人。

使用建议

新增任务时，建议按基本信息 -> 稽查对象 -> 稽查规则 -> 保存并退出的顺序完成配置。保存前先确认必填项、对象信息和规则参数已经补全。

主要特性

质量评测任务管理：支持新增、编辑、删除、详情查看和任务执行；
三步向导配置：新增任务时依次维护基本信息、稽查对象和稽查规则；
稽查对象配置：从指定数据源加载表结构，支持选择多张表作为评测目标；
规则配置管理：每个对象可配置多个稽查规则，支持新增、启用、禁用、编辑和删除；
执行记录追溯：任务执行后可查看执行记录、运行日志和执行详情；
质量报告联动：每次执行任务均可形成质量评测记录，支撑问题数据定位和治理闭环。

作用范围

本功能适用于数据治理过程中的质量评测任务创建、规则配置、任务执行和执行结果追溯。主要面向数据治理管理员、治理运维人员、数据负责人和只读审阅人员。页面按钮和数据范围受平台权限配置影响。

前置步骤

前置条件

已登录 qData 平台，并具备【数据资产】相关菜单访问权限。
已切换到正确项目、租户或业务空间。
已准备质量任务所需的数据连接、稽查对象、规则口径、责任人和调度资源。
如需手动执行任务，目标任务需处于上线或启用状态。

导航路径

数据资产 > 数据质量 > 数据质量任务

页面总览

点击【数据资产】->【数据质量】下的【数据质量任务】，进入数据质量任务页面。页面采用左右布局：左侧树形展示数据质量类目，右侧显示数据质量任务列表，包含编号、任务名称、稽查对象数、稽查规则数、任务状态、执行策略、所属分类等字段。

数据质量任务.png

区域	主要内容	使用说明
左侧类目树	数据质量任务分类	用于按分类定位任务。
查询与操作区	查询条件、新增、批量操作入口	用于筛选任务和创建任务。
任务列表	任务名称、对象数、规则数、状态、执行策略、所属分类	用于查看任务配置概况。
行操作	配置、详情、更多	用于编辑、执行、查看记录和日志。

推荐操作流程

新增任务：进入【数据质量任务】 -> 点击【新增】 -> 填写基本信息 -> 新增稽查对象 -> 配置稽查规则 -> 保存并退出。

调整任务：定位目标任务 -> 点击【配置】 -> 修改基本信息、稽查对象或稽查规则 -> 保存并退出。

执行与追溯：确认任务已启用 -> 点击【更多】->【执行一次】 -> 查看执行记录 -> 查看日志或详情。

功能操作说明

新增数据质量任务

点击【新增】按钮，在出现的新增页面中依次配置基本信息、稽查对象、稽查规则三个部分。填写完成后点击【保存并退出】，完成数据质量任务新增。当基本信息、稽查对象、稽查规则需要调整时，可点击【上一步】返回修改。

基本信息

填写基本信息以及属性信息，完成后点击【下一步】，进入稽查对象配置。

基本信息.png

字段名	说明	是否必填
任务分类	选择质量任务归属分类，便于按分类管理任务。	是
执行策略	选择任务执行方式。	是
调度周期	配置任务周期调度规则，可通过旁侧【配置】入口维护。	是
任务名称	填写用于识别质量任务的名称。	是
责任人	选择任务维护或负责人员。	按页面标识
任务状态	选择任务上线或下线状态。	系统默认选中
任务描述	填写任务用途、评测范围或业务说明。	否
任务优先级	设置任务调度优先级。	是
Worker 分组	选择任务运行资源分组。	是
失败重试次数	设置任务执行失败后的重试次数。	否
延迟执行时间	设置任务延迟执行时间，单位为分钟。	否
备注	填写补充说明。	否

稽查对象

点击【新增】按钮，在弹出框中填写稽查对象信息，并点击【确定】按钮，完成稽查对象新增。完成后点击【下一步】，进入稽查规则配置。

稽查对象1.png

稽查对象2.png

稽查对象来源于数据连接中可选择的数据对象，支持多对象配置。配置时应确认数据源、库表对象和字段范围是否符合当前质量评测目标。

配置项	说明	注意事项
数据源	稽查对象所属数据连接。	需确保连接正常且账号具备读取权限。
数据库 / Schema	稽查对象所在库或命名空间。	应选择目标业务数据所在范围。
数据表	参与质量评测的表对象。	可按任务目标选择一张或多张表。
字段	后续规则可引用的检查字段。	应与规则类型匹配。

稽查规则

点击【新增】按钮，在新增评测信息弹出框内选择稽查对象，填写稽查规则信息，并点击【确定】按钮，完成稽查规则新增。完成后点击【保存并退出】，即可创建数据质量任务。

稽查规则1.png

稽查规则2.png

稽查规则3.png

配置稽查规则时，通常需要完成以下步骤：

选择稽查对象。
选择质量维度、规则分类和规则项。
填写评测名称、告警等级、状态、规则描述、错误示例和修复建议。
按需填写 Where 条件。
按所选规则项补充特有参数。
点击【确定】保存规则配置。

规则信息	说明	注意事项
质量维度	规范性、完整性、准确性、一致性、时效性等维度。	应匹配当前业务质量目标。
规则分类	规则所属分类。	用于缩小规则选择范围。
规则项	实际执行的质量稽查规则。	不同规则项会展示不同参数。
评测名称	当前评测项名称。	建议体现对象和规则含义。
告警等级	规则命中后的问题等级。	应结合业务影响配置。
Where 条件	限制参与评测的数据范围。	大表建议配置必要过滤条件。

编辑数据质量任务

点击所需编辑的数据质量任务，在操作列中点击【配置】按钮，进入数据质量任务编辑页面。编辑页面与新增流程一致，可调整基本信息、稽查对象和稽查规则。

编辑数据质量任务.png

编辑任务时，建议先确认任务是否正在执行。若任务正在运行，应等待执行完成后再调整配置，避免影响本次执行结果。

数据质量任务详情

点击所需查看详情的数据质量任务，在操作列中点击【详情】按钮，进入数据质量任务详情页面。

数据质量任务详情1.png

数据质量任务详情2.png

数据质量任务详情3.png

详情页用于只读查看任务配置，通常包含基本信息、稽查对象和稽查规则。查看详情不会修改任务配置。

执行一次

选择需执行一次的数据质量任务，在操作列中点击【更多】->【执行一次】按钮，系统将执行一次该任务，并提示相关信息。

执行一次.png

注意事项

执行一次时，任务需处于启用状态。执行前应确认稽查对象的数据源连接正常，避免因连接或权限问题导致任务失败。

查看执行记录

选择需查看执行记录的数据质量任务，在操作列中点击【更多】->【执行记录】按钮，在弹出框中查看执行记录列表。

查看执行记录.png

执行记录用于追踪每次任务运行情况，常见信息包括执行时间、执行状态、耗时、触发方式和操作入口。

查看日志

选择需要查看日志的执行记录，在操作列中点击【查看日志】按钮，在弹出框中查看日志。

查看日志.png

日志排查时，优先关注数据源连接、权限、SQL 执行、规则参数和任务调度相关错误信息。

执行记录详情

选择需要查看详情的执行记录，在操作列中点击【详情】按钮，跳转到【质量任务日志】中进行详情查看。

详情.png

执行记录详情可用于进一步查看本次质量任务执行结果，并与质量报告或问题数据排查流程衔接。

启停和删除质量任务

在质量任务列表中定位目标任务。
点击状态开关或启停入口。
按页面提示确认操作。
如需删除任务，点击目标任务对应的【删除】。
在删除确认提示中点击【确定】。

启停任务前应确认任务当前是否被调度使用；删除任务前应确认是否需要保留历史执行记录和质量报告。

常见问题

执行一次有什么前提？
执行一次需在任务启用后进行，并确保数据源连接、权限和规则参数正常。
稽查规则为什么保存失败？
可能是必填字段未填写、规则参数缺失、稽查对象未选择或规则与字段类型不匹配。建议逐项检查规则弹窗中的必填项。
查看日志主要看什么？
优先查看连接异常、权限异常、SQL 执行异常、规则参数异常和调度资源异常。
编辑任务后会影响历史执行记录吗？
编辑会影响后续执行配置，历史执行记录通常用于追踪当时的运行结果。具体保留策略以系统实际配置为准。
删除或停用任务前需要确认什么？
需要确认是否仍有调度依赖、质量报告追溯要求或下游治理流程依赖。

总结

数据质量任务用于把数据质量稽查规则应用到具体数据对象上，形成可执行、可追溯的质量评测任务。用户通过三步向导完成基本信息、稽查对象和稽查规则配置后，可在列表中继续进行配置、执行、记录查看和日志排查。