GetDataQualityRuleTemplate - 查询质量规则模版详情

更新时间:2025-04-03 10:37

查询质量规则模版详情。

接口说明

需要购买 DataWorks 基础版及以上版本才能使用

调试

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

授权信息

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

请求参数

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

规则模版 Code。

USER_DEFINED:123

返回参数

名称类型描述示例值
名称类型描述示例值
object

返回值。

RequestIdstring

API 请求 ID。

691CA452-D37A-4E****
DataQualityRuleTemplateobject

规则模版详情。

Codestring

规则模版 Code。

USER_DEFINED:123
Namestring

规则模板名称,数字、英文字母、汉字、半角全角标点符号组合,最长 512 个字符。

Table row Count Verification
ProjectIdlong

DataWorks 工作空间 ID。

4020
SamplingConfigobject

样本采集所需的设置。

Metricstring

采样的指标名称:

  • Count:表行数
  • Min:字段最小值
  • Max:字段最大值
  • Avg:字段均值
  • DistinctCount:字段唯一值个数
  • DistinctPercent:字段唯一值个数与数据行数占比
  • DuplicatedCount:字段重复值个数
  • DuplicatedPercent:字段重复值个数与数据行数占比
  • TableSize:表大小
  • NullValueCount:字段为空的行数
  • NullValuePercent:字段为空的比例
  • GroupCount:按字段值聚合后每个值与对应的数据行数
  • CountNotIn:枚举值不匹配行数
  • CountDistinctNotIn:枚举值不匹配唯一值个数
  • UserDefinedSql:通过自定义 SQL 做样本采集
Max
MetricParametersstring

样本采集时,所需的参数。

{"SQL": "select count(1) from table;"}
SettingConfigstring

具体执行采样语句前,插入执行的一些运行时参数设置语句,最长 1000 个字符。目前只支持 MaxCompute。

SET odps.sql.udf.timeout=600s; SET odps.sql.python.version=cp27;
CheckingConfigobject

样本校验设置。

Typestring

阈值计算方式:

  • Fixed
  • Fluctation
  • FluctationDiscreate
  • Auto
  • Average
  • Variance
Fixed
ReferencedSamplesFilterstring

有些类型的阈值需要查询出一些参考样本,然后对参考样本的值进行汇总得出进行比较的阈值,这里使用一个表达式来表示参考样本的查询方式。

{ "bizdate": [ "-1", "-7", "-1m" ] }
VisibleScopestring

模板的可用范围:

  • Tenant:全租户都可用
  • Project:只在当前项目中可用
Project
DirectoryPathstring

自定义模板被存放的类目目录,斜线分隔层级。每个层级名称最长 1024 个字符,由不能包含空白字符、不能包含斜线。

/ods/order_data

示例

正常返回示例

JSON格式

{
  "RequestId": "691CA452-D37A-4E****",
  "DataQualityRuleTemplate": {
    "Code": "USER_DEFINED:123",
    "Name": "Table row Count Verification",
    "ProjectId": 4020,
    "SamplingConfig": {
      "Metric": "Max",
      "MetricParameters": "{\"SQL\": \"select count(1) from table;\"}",
      "SettingConfig": "SET odps.sql.udf.timeout=600s; \nSET odps.sql.python.version=cp27;\n"
    },
    "CheckingConfig": {
      "Type": "Fixed",
      "ReferencedSamplesFilter": "{ \"bizdate\": [ \"-1\", \"-7\", \"-1m\" ] }\n"
    },
    "VisibleScope": "Project",
    "DirectoryPath": "/ods/order_data"
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
变更时间变更内容概要操作
2024-12-19OpenAPI 返回结构发生变更查看变更详情
2024-12-19API 内部配置变更,不影响调用查看变更详情
  • 本页导读 (1)
  • 接口说明
  • 调试
  • 授权信息
  • 请求参数
  • 返回参数
  • 示例
  • 错误码
  • 变更历史
文档反馈