全部产品
Search
文档中心

大数据开发治理平台 DataWorks:UpdateQualityRule - 更新规则

更新时间:Nov 15, 2024

调用UpdateQualityRule更新校验规则的信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
BlockTypeinteger

校验规则的强弱。强弱表示规则的重要程度。取值如下:

  • 1,表示强规则。
  • 0,表示弱规则。 您可以根据实际需求设置重要的规则为强规则。如果使用强规则并触发了红色告警,则会阻塞调度任务。
0
EntityIdlong

分区表达式的 ID。您可以调用 ListQualityRules 接口获分区表达式 ID。

123
Commentstring

校验规则的描述信息。

校验表行数
Checkerinteger

校验器 ID。 2,表示 7 天平均值波动。 3,表示 30 天平均值波动。 4,表示 1 天周期比较。 5,表示 7 天周期比较。 6,表示 30 天周期比较。 7,表示 7 天方差波动。 8,表示 30 天方差波动。 9,表示与固定值比较。 10,表示 1、7、30 天波动检测。 11,表示上一周期比较。 您可以调用 ListQualityRules 接口获取校验器 ID。

9
ExpectValuestring

校验结果的期望值。

300
Idlong

校验规则的 ID。您可以调用 ListQualityRules 接口获取规则 ID。

1234
Trendstring

校验结果的趋势。取值如下:

  • up,表示上升趋势。
  • down,表示下降趋势。
  • abs,表示绝对值。
up
MethodNamestring

采集样本数据方法的名称。包括 avg、count、sum、min、max、count_distinct、user_defined、table_count、table_size、table_dt_load_count、table_dt_refuseload_count、null_value、null_value/table_count、(table_count-count_distinct)/table_count、table_count-count_distinct 等。

table_count
Operatorstring

比较符。包括>、>=、=、≠、<和<=等。

说明 当 Checker=9 时,Operator 为必选参数。
>
ProjectNamestring

引擎或者数据源的名称。您可以登录 DataWorks 控制台,进入工作空间管理页面获取名称。

autotest
Propertystring

字段的名称。

id
PropertyTypestring

字段的类型。

bigint
RuleTypeinteger

规则的类型:

  • 0 表示系统创建。
  • 1 表示用户创建。
  • 2 表示项目级规则。
0
WhereConditionstring

校验任务使用的过滤条件或自定义 SQL 语句。

dt=$[yyyymmdd]
CriticalThresholdstring

红色告警阈值。表示与样本预期的偏离程度。您可以根据业务需求自定义该阈值。使用强规则并触发红色阈值,会阻塞调度任务。

10
WarningThresholdstring

橙色告警阈值。表示与样本预期的偏离程度,您可以根据业务需求自定义该阈值。

5
TemplateIdinteger

使用的校验模板的 ID。您可以调用 ListQualityRules 接口获取校验模板的 ID。

7
RuleNamestring

校验规则的名称。

123
PredictTypeinteger

是否为动态阈值。取值如下:

  • 0,表示非动态阈值。
  • 2,表示动态阈值。
0
OpenSwitchboolean

规则的启用或停用状态,用于控制质量规则是否在生产环境中运行。

  • true:在数据质量规则关联产出表数据的调度任务执行时,便会触发质量规则校验。

  • false:在数据质量规则关联产出表数据的调度任务执行时,不会触发质量规则校验。

true
ProjectIdlong

DataWorks 项目空间 ID。

26
TaskSettingstring

在自定义规则之前插入的变量设置,格式如:x=a,y=b

x=a,y=b

返回参数

名称类型描述示例值
object

返回数据结构。

HttpStatusCodeinteger

HTTP 返回码。

200
Databoolean

校验规则是否更新成功。

true
ErrorMessagestring

错误信息。

You have no permission.
RequestIdstring

请求 ID。用于出现错误后排查问题。

576b9457-2cf5-4****
ErrorCodestring

错误码。

0
Successboolean

调用是否成功。

true

示例

正常返回示例

JSON格式

{
  "HttpStatusCode": 200,
  "Data": true,
  "ErrorMessage": "You have no permission.",
  "RequestId": "576b9457-2cf5-4****",
  "ErrorCode": "0",
  "Success": true
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-11-14API 内部配置变更,不影响调用查看变更详情
2023-11-15OpenAPI 入参发生变更查看变更详情
2023-03-08OpenAPI 入参发生变更查看变更详情