文档首页/ 数据治理中心 DataArts Studio/ API参考/ 数据架构API/ 质量规则接口/ 更新表的异常数据输出配置
更新时间：2024-11-06 GMT+08:00
在线调试
CLI示例
查看PDF
分享

更新表的异常数据输出配置

功能介绍

更新表的异常数据输出配置，包括是否生成异常数据、设置异常数据数据库或Schema、设置异常表表前缀/表后缀。

调用方法

请参见如何调用API。

URI

PUT /v2/{project_id}/design/{table_id}/qualities

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参见项目ID和账号ID。

table_id

是

String

表的ID，填写String类型替代Long类型。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

IAM Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

使用Token认证时必选。

workspace

是

String

工作空间ID，获取方法请参见实例ID和工作空间ID。

X-Project-Id

否

String

项目ID，获取方法请参见项目ID和账号ID。

多project场景采用AK/SK认证的接口请求，则该字段必选。

Content-Type

否

String

默认值：application/json;charset=UTF-8

可选，有Body体的情况下必选，没有Body体则无需填写和校验。
表3 请求Body参数

参数

是否必选

参数类型

描述

biz_type

否

String

表类型。

枚举值：

  • TABLE_MODEL: 关系模型（逻辑模型/物理模型）

  • AGGREGATION_LOGIC_TABLE: 汇总表

  • FACT_LOGIC_TABLE: 事实表

  • DIMENSION: 维度

  • DIMENSION_LOGIC_TABLE: 维度表

dirty_out_switch

否

Boolean

异常数据输出开关。

dirty_out_database

否

String

异常数据输出库。

dirty_out_prefix

否

String

异常表前缀。

dirty_out_suffix

否

String

异常表后缀。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

data

data object

更新表的异常数据输出配置返回数据。
表5 data

参数

参数类型

描述

value

TableModelVO object

表的详情信息。
表6 TableModelVO

参数

参数类型

描述

id

String

编码，填写String类型替代Long类型。

model_id

String

所属关系建模的模型ID，填写String类型替代Long类型。

parent_table_id

String

父表ID，填写String类型替代Long类型。

parent_table_name

String

父表名称，只读。

parent_table_code

String

父表编码，只读。

related_logic_table_id

String

关联逻辑实体的ID，填写String类型替代Long类型。

related_logic_table_name

String

关联逻辑实体的名称。

related_logic_table_model_id

String

关联逻辑实体的模型ID，填写String类型替代Long类型。

related_logic_table_model_name

String

关联逻辑实体的模型名称。

model

WorkspaceVO object

模型信息。

data_format

String

数据格式。

obs_bucket

String

obs桶。

obs_location

String

外表路径

configs

String

其他配置。

table_type

String

表类型，只读。

owner

String

负责人。

tb_name

String

表名。

dw_id

String

数据连接ID。

db_name

String

数据库名。

queue_name

String

dli数据连接执行sql所需的队列，数据连接类型为DLI时必须。

schema

String

DWS类型需要。

extend_info

String

扩展信息。

tb_guid

String

表物化后的guid，只读。

tb_id

String

数据表ID，只读。

logic_tb_name

String

逻辑实体名。

logic_tb_guid

String

逻辑实体的guid，只读。

description

String

描述。

status

String

实体的发布状态，只读，创建和更新时无需填写。

枚举值：

  • DRAFT: 草稿

  • PUBLISH_DEVELOPING: 发布待审核

  • PUBLISHED: 已发布

  • OFFLINE_DEVELOPING: 下线待审核

  • OFFLINE: 已下线

  • REJECT: 已驳回

logic_tb_id

String

逻辑实体的ID，填写String类型替代Long类型。

biz_catalog_id

String

归属的业务分类的id，填写String类型替代Long类型。

catalog_path

String

归属的业务分类的路径 {"l1Id":"","l2Id":"","l3Id":""}。

create_by

String

创建人，只读。

update_by

String

更新人，只读。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

tags

Array of TagRecordVO objects

表标签，只读。

approval_info

ApprovalVO object

审批信息,只读参数。业务对象最近一次的审批信息，包括审批的业务详情、审核人信息、审核时间等。

new_biz

BizVersionManageVO object

业务版本管理，只读。

attributes

Array of TableModelAttributeVO objects

表属性信息。

mappings

Array of TableMappingVO objects

表映射信息。

relations

Array of RelationVO objects

关系。

dw_type

String

数据连接类型，对应表所在的数仓类型，取值可以为DWS、MRS_HIVE、POSTGRESQL、MRS_SPARK、CLICKHOUSE、MYSQL、ORACLE和DORIS等。

dw_name

String

数据连接名称，只读，创建和更新时无需填写。

l1

String

主题域分组中文名，只读，创建和更新时无需填写。

l2

String

主题域中文名，只读，创建和更新时无需填写。

l3

String

业务对象中文名，只读，创建和更新时无需填写。

l1_id

String

主题域分组ID，只读，填写String类型替代Long类型。

l2_id

String

主题域ID。

l3_id

String

业务对象ID，只读，填写String类型替代Long类型。

partition_conf

String

分区表达式。

dlf_task_id

String

DLF作业ID。

use_recently_partition

Boolean

是否使用最新分区。

reversed

Boolean

是否是逆向的。

dirty_out_switch

Boolean

异常数据输出开关。

dirty_out_database

String

异常数据输出库。

dirty_out_prefix

String

异常表前缀。

dirty_out_suffix

String

异常表后缀。

quality_owner

String

质量责任人。

quality_id

String

质量ID，填写String类型替代Long类型。

distribute

String

DISTRIBUTE BY [HASH(column)|REPLICATION]。

枚举值：

  • HASH: 对指定的列进行Hash，通过映射，把数据分布到指定DN

  • REPLICATION: 表的每一行存在所有数据节点（DN）中，即每个数据节点都有完整的表数据

distribute_column

String

DISTRIBUTE BY HASH column.

is_partition

Boolean

是否分区表，只读。

physical_table

String

生产环境创建表状态。

dev_physical_table

String

开发环境创建表状态。

technical_asset

String

技术资产同步状态，只读。

business_asset

String

业务资产同步状态，只读。

meta_data_link

String

资产关联状态，只读。

data_quality

String

质量作业状态，只读。

summary_status

String

同步整体状态，只读。

dev_version

String

开发环境版本，填写String类型替代Long类型。

prod_version

String

生产环境版本，填写String类型替代Long类型。

dev_version_name

String

开发环境版本名称。

prod_version_name

String

生产环境版本名称。

env_type

String

开发生产环境类型。

枚举值：

  • INVALID_TYPE: 无效环境

  • DEV_TYPE: 开发环境

  • PROD_TYPE: 生产环境

  • DEV_PROD_TYPE: 开发生产环境

alias

String

别名。

self_defined_fields

Array of SelfDefinedFieldVO objects

自定义项。

code

String

编码

has_related_physical_table

Boolean

是否存在关联物理表。

has_related_logic_table

Boolean

是否存在关联逻辑实体。
表7 WorkspaceVO

参数

参数类型

描述

id

String

编号，填写String类型替代Long类型。

name

String

工作区名字。

description

String

描述。

is_physical

Boolean

是否为物理表。

frequent

Boolean

是否为常用。

top

Boolean

分层治理。

level

String

数据治理分层。

枚举值：

  • SDI: 贴源数据层

  • DWI: 数据整合层

  • DWR: 数据报告层

  • DM: 数据集市层

dw_type

String

数据连接类型，对应表所在的数仓类型，取值可以为DWS、MRS_HIVE、POSTGRESQL、MRS_SPARK、CLICKHOUSE、MYSQL、ORACLE和DORIS等。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

create_by

String

创建人。

update_by

String

更新人。

type

String

工作区类型枚举。

枚举值：

  • THIRD_NF: 关系建模

  • DIMENSION: 维度建模

biz_catalog_ids

String

关联的业务分层的ID列表 {"l1Ids":[],"l2Ids":[],"l3Ids":[]}。

databases

Array of strings

数据库名称数组。

table_model_prefix

String

模型校验前缀，长度不超过100，数字字母下划线组成，字母开头
表8 TagRecordVO

参数

参数类型

描述

id

String

编码，填写String类型替代Long类型。

tag_id

String

标签ID，填写String类型替代Long类型。

tag_name

String

标签名称。

biz_id

String

实体ID，填写String类型替代Long类型。

biz_type

String

业务实体类型。

枚举值：

  • AGGREGATION_LOGIC_TABLE: 汇总表

  • ATOMIC_INDEX: 原子指标

  • ATOMIC_METRIC: 原子指标（新）

  • BIZ_CATALOG: 流程架构目录

  • BIZ_METRIC: 业务指标

  • CODE_TABLE: 码表

  • COMMON_CONDITION: 通用限定

  • COMPOSITE_METRIC: 复合指标（新）

  • COMPOUND_METRIC: 复合指标

  • CONDITION_GROUP: 限定分组

  • DEGENERATE_DIMENSION: 退化维度

  • DERIVATIVE_INDEX: 衍生指标

  • DERIVED_METRIC: 衍生指标（新）

  • DIMENSION: 维度

  • DIMENSION_ATTRIBUTE: 维度属性

  • DIMENSION_HIERARCHIES: 维度层级

  • DIMENSION_LOGIC_TABLE: 维度表

  • DIMENSION_TABLE_ATTRIBUTE: 维度属性

  • DIRECTORY: 目录

  • FACT_ATTRIBUTE: 事实表属性

  • FACT_DIMENSION: 事实表维度

  • FACT_LOGIC_TABLE: 事实表

  • FACT_MEASURE: 事实表度量

  • FUNCTION: 函数

  • INFO_ARCH: 信息架构（批量修改主题使用）

  • MODEL: 模型

  • QUALITY_RULE: 质量规则

  • SECRECY_LEVEL: 密级

  • STANDARD_ELEMENT: 数据标准

  • STANDARD_ELEMENT_TEMPLATE: 数据标准模板

  • SUBJECT: 主题

  • SUMMARY_DIMENSION_ATTRIBUTE: 汇总表维度属性

  • SUMMARY_INDEX: 汇总表指标属性

  • SUMMARY_TIME: 汇总表时间周期属性

  • TABLE_MODEL: 关系模型（逻辑模型/物理模型）

  • TABLE_MODEL_ATTRIBUTE: 关系模型属性（逻辑模型/物理模型）

  • TABLE_MODEL_LOGIC: 逻辑实体

  • TABLE_TYPE: 表类型

  • TAG: 标签

  • TIME_CONDITION: 时间限定

create_by

String

创建人。

update_by

String

更新人。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。
表9 ApprovalVO

参数

参数类型

描述

id

String

审批单ID，填写String类型替代Long类型。

tenant_id

String

项目ID，获取方式参考接口路径参数“project_id”。

name_ch

String

业务中文名。

name_en

String

业务英文名。

biz_id

String

业务ID，填写String类型替代Long类型。

biz_type

String

业务实体类型。

枚举值：

  • AGGREGATION_LOGIC_TABLE: 汇总表

  • ATOMIC_INDEX: 原子指标

  • ATOMIC_METRIC: 原子指标（新）

  • BIZ_CATALOG: 流程架构目录

  • BIZ_METRIC: 业务指标

  • CODE_TABLE: 码表

  • COMMON_CONDITION: 通用限定

  • COMPOSITE_METRIC: 复合指标（新）

  • COMPOUND_METRIC: 复合指标

  • CONDITION_GROUP: 限定分组

  • DEGENERATE_DIMENSION: 退化维度

  • DERIVATIVE_INDEX: 衍生指标

  • DERIVED_METRIC: 衍生指标（新）

  • DIMENSION: 维度

  • DIMENSION_ATTRIBUTE: 维度属性

  • DIMENSION_HIERARCHIES: 维度层级

  • DIMENSION_LOGIC_TABLE: 维度表

  • DIMENSION_TABLE_ATTRIBUTE: 维度属性

  • DIRECTORY: 目录

  • FACT_ATTRIBUTE: 事实表属性

  • FACT_DIMENSION: 事实表维度

  • FACT_LOGIC_TABLE: 事实表

  • FACT_MEASURE: 事实表度量

  • FUNCTION: 函数

  • INFO_ARCH: 信息架构（批量修改主题使用）

  • MODEL: 模型

  • QUALITY_RULE: 质量规则

  • SECRECY_LEVEL: 密级

  • STANDARD_ELEMENT: 数据标准

  • STANDARD_ELEMENT_TEMPLATE: 数据标准模板

  • SUBJECT: 主题

  • SUMMARY_DIMENSION_ATTRIBUTE: 汇总表维度属性

  • SUMMARY_INDEX: 汇总表指标属性

  • SUMMARY_TIME: 汇总表时间周期属性

  • TABLE_MODEL: 关系模型（逻辑模型/物理模型）

  • TABLE_MODEL_ATTRIBUTE: 关系模型属性（逻辑模型/物理模型）

  • TABLE_MODEL_LOGIC: 逻辑实体

  • TABLE_TYPE: 表类型

  • TAG: 标签

  • TIME_CONDITION: 时间限定

biz_info

String

序列化之后的业务详情，类型是string。

biz_info_obj

Object

业务详情，类型是object。

biz_version

Integer

业务版本。

biz_status

String

实体的发布状态，只读，创建和更新时无需填写。

枚举值：

  • DRAFT: 草稿

  • PUBLISH_DEVELOPING: 发布待审核

  • PUBLISHED: 已发布

  • OFFLINE_DEVELOPING: 下线待审核

  • OFFLINE: 已下线

  • REJECT: 已驳回

approval_status

String

业务审批状态，只读。

枚举值：

  • DEVELOPING: 审核中

  • APPROVED: 审核通过

  • REJECT: 审核驳回

  • WITHDREW: 审核撤销

approval_type

String

业务审核类型。

枚举值：

  • PUBLISH: 发布

  • OFFLINE: 下线

submit_time

String

提交时间。

create_by

String

创建者。

l1

String

主题域分组中文名，只读，创建和更新时无需填写。

l2

String

主题域中文名，只读，创建和更新时无需填写。

l3

String

业务对象中文名，只读，创建和更新时无需填写。

approval_time

String

审核时间。

approver

String

审核人。

email

String

审核人邮箱。

msg

String

审核信息。

directory_path

String

目录树。
表10 TableModelAttributeVO

参数

参数类型

描述

id

String

编码，填写String类型替代Long类型。

name_en

String

字段名。

name_ch

String

业务属性。

description

String

描述。

obs_location

String

obs路径，子路径。

create_by

String

创建人。

update_by

String

更新人。

data_type

String

字段类型。

domain_type

String

字段类型所属域。

枚举值：

  • NUMBER: 数字类型

  • STRING: 字符类型

  • DATETIME: 日期类型

  • BLOB: 大对象(BLOB)

  • OTHER: 其它类型

data_type_extend

String

数据类型扩展字段。

is_primary_key

Boolean

是否主键。

is_partition_key

Boolean

是否分区键。

is_foreign_key

Boolean

是否外键。

extend_field

Boolean

是否继承的属性。

not_null

Boolean

是否不为空。

ordinal

Integer

序号。

table_model_id

String

所属关系建模的模型ID，填写String类型替代Long类型。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

tags

Array of TagVO objects

表标签，只读。

secrecy_levels

Array of SecrecyLevelVO objects

密级

stand_row_id

String

关联的数据标准的ID，填写String类型替代Long类型。

stand_row_name

String

关联的数据标准名称，只读。

quality_infos

Array of QualityInfoVO objects

质量信息，只读。

alias

String

别名。

self_defined_fields

Array of SelfDefinedFieldVO objects

自定义项。

code

String

逻辑属性编码

related_logic_attr_id

String

关联逻辑属性ID，填写String类型替代Long类型。

related_logic_attr_name

String

关联逻辑实体属性中文名称

related_logic_attr_name_en

String

关联逻辑实体属性英文名称
表11 TagVO

参数

参数类型

描述

id

String

编码，填写String类型替代Long类型。

name

String

标签名。

description

String

描述。

create_by

String

创建人。

update_by

String

更新人。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

new_biz

BizVersionManageVO object

业务版本管理，只读。
表12 SecrecyLevelVO

参数

参数类型

描述

id

String

密级ID，填写String类型替代Long类型。

uuid

String

数据安全主键。

name

String

密级名。

slevel

Integer

密级等级。

description

String

密级描述。

create_by

String

创建人。

update_by

String

更新人。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

new_biz

BizVersionManageVO object

业务版本管理，只读。
表13 BizVersionManageVO

参数

参数类型

描述

id

String

ID信息，填写String类型替代Long类型。

biz_type

String

业务实体类型。

枚举值：

  • AGGREGATION_LOGIC_TABLE: 汇总表

  • ATOMIC_INDEX: 原子指标

  • ATOMIC_METRIC: 原子指标（新）

  • BIZ_CATALOG: 流程架构目录

  • BIZ_METRIC: 业务指标

  • CODE_TABLE: 码表

  • COMMON_CONDITION: 通用限定

  • COMPOSITE_METRIC: 复合指标（新）

  • COMPOUND_METRIC: 复合指标

  • CONDITION_GROUP: 限定分组

  • DEGENERATE_DIMENSION: 退化维度

  • DERIVATIVE_INDEX: 衍生指标

  • DERIVED_METRIC: 衍生指标（新）

  • DIMENSION: 维度

  • DIMENSION_ATTRIBUTE: 维度属性

  • DIMENSION_HIERARCHIES: 维度层级

  • DIMENSION_LOGIC_TABLE: 维度表

  • DIMENSION_TABLE_ATTRIBUTE: 维度属性

  • DIRECTORY: 目录

  • FACT_ATTRIBUTE: 事实表属性

  • FACT_DIMENSION: 事实表维度

  • FACT_LOGIC_TABLE: 事实表

  • FACT_MEASURE: 事实表度量

  • FUNCTION: 函数

  • INFO_ARCH: 信息架构（批量修改主题使用）

  • MODEL: 模型

  • QUALITY_RULE: 质量规则

  • SECRECY_LEVEL: 密级

  • STANDARD_ELEMENT: 数据标准

  • STANDARD_ELEMENT_TEMPLATE: 数据标准模板

  • SUBJECT: 主题

  • SUMMARY_DIMENSION_ATTRIBUTE: 汇总表维度属性

  • SUMMARY_INDEX: 汇总表指标属性

  • SUMMARY_TIME: 汇总表时间周期属性

  • TABLE_MODEL: 关系模型（逻辑模型/物理模型）

  • TABLE_MODEL_ATTRIBUTE: 关系模型属性（逻辑模型/物理模型）

  • TABLE_MODEL_LOGIC: 逻辑实体

  • TABLE_TYPE: 表类型

  • TAG: 标签

  • TIME_CONDITION: 时间限定

biz_id

String

业务ID，填写String类型替代Long类型。

biz_info

String

业务对象信息。

status

String

实体的发布状态，只读，创建和更新时无需填写。

枚举值：

  • DRAFT: 草稿

  • PUBLISH_DEVELOPING: 发布待审核

  • PUBLISHED: 已发布

  • OFFLINE_DEVELOPING: 下线待审核

  • OFFLINE: 已下线

  • REJECT: 已驳回

biz_version

Integer

业务版本，只读。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。
表14 QualityInfoVO

参数

参数类型

描述

id

String

编码ID，填写String类型替代Long类型。

table_id

String

表ID，只读，填写String类型替代Long类型。

attr_id

String

属性ID，只读，填写String类型替代Long类型。

biz_type

String

业务实体类型。

枚举值：

  • AGGREGATION_LOGIC_TABLE: 汇总表

  • ATOMIC_INDEX: 原子指标

  • ATOMIC_METRIC: 原子指标（新）

  • BIZ_CATALOG: 流程架构目录

  • BIZ_METRIC: 业务指标

  • CODE_TABLE: 码表

  • COMMON_CONDITION: 通用限定

  • COMPOSITE_METRIC: 复合指标（新）

  • COMPOUND_METRIC: 复合指标

  • CONDITION_GROUP: 限定分组

  • DEGENERATE_DIMENSION: 退化维度

  • DERIVATIVE_INDEX: 衍生指标

  • DERIVED_METRIC: 衍生指标（新）

  • DIMENSION: 维度

  • DIMENSION_ATTRIBUTE: 维度属性

  • DIMENSION_HIERARCHIES: 维度层级

  • DIMENSION_LOGIC_TABLE: 维度表

  • DIMENSION_TABLE_ATTRIBUTE: 维度属性

  • DIRECTORY: 目录

  • FACT_ATTRIBUTE: 事实表属性

  • FACT_DIMENSION: 事实表维度

  • FACT_LOGIC_TABLE: 事实表

  • FACT_MEASURE: 事实表度量

  • FUNCTION: 函数

  • INFO_ARCH: 信息架构（批量修改主题使用）

  • MODEL: 模型

  • QUALITY_RULE: 质量规则

  • SECRECY_LEVEL: 密级

  • STANDARD_ELEMENT: 数据标准

  • STANDARD_ELEMENT_TEMPLATE: 数据标准模板

  • SUBJECT: 主题

  • SUMMARY_DIMENSION_ATTRIBUTE: 汇总表维度属性

  • SUMMARY_INDEX: 汇总表指标属性

  • SUMMARY_TIME: 汇总表时间周期属性

  • TABLE_MODEL: 关系模型（逻辑模型/物理模型）

  • TABLE_MODEL_ATTRIBUTE: 关系模型属性（逻辑模型/物理模型）

  • TABLE_MODEL_LOGIC: 逻辑实体

  • TABLE_TYPE: 表类型

  • TAG: 标签

  • TIME_CONDITION: 时间限定

data_quality_id

String

质量ID，填写String类型替代Long类型。

show_control

Integer

是否要显示正则表达式。

data_quality_name

String

质量名称。

alert_conf

String

告警配置。

expression

String

正则相关校验规则中正则配置。

extend_info

String

扩展信息。

from_standard

Boolean

是否来源于数据标准质量配置，只读。

result_description

String

结果说明。

create_by

String

创建人，只读。

update_by

String

更新人，只读。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。
表15 TableMappingVO

参数

参数类型

描述

id

String

编码，填写String类型替代Long类型。

name

String

名称。

description

String

描述。

target_table_id

String

目的表ID，填写String类型替代Long类型。

src_model_id

String

来源表在关系建模中的模型ID，填写String类型替代Long类型。

src_model_name

String

来源模型名称。

view_text

String

采集的视图来源，dws视图逆向使用。

target_table_name

String

目的表名称。

details

Array of TableMappingDetailVO objects

详情。

source_tables

Array of MappingSourceTableVO objects

映射的表信息。

source_fields

Array of MappingSourceFieldVO objects

映射的字段信息。

create_time

String

创建时间，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

create_by

String

创建人。

update_by

String

更新人。
表16 TableMappingDetailVO

参数

参数类型

描述

id

String

编码，填写String类型替代Long类型。

mapping_id

String

名称。

target_attr_id

String

目的字段ID，填写String类型替代Long类型。

target_attr_name

String

目的字段排序。

src_table_ids

String

源表ID。

src_table_names

Array of strings

源表名称数组，只读。

src_table_db_names

Array of strings

源表db名称数组，只读。

src_table_model_ids

Array of strings

源表在关系建模中的模型ID数组，只读，填写String类型替代Long类型。

src_table_id_list

Array of strings

源表ID数组，只读，填写String类型替代Long类型。

src_attr_ids

String

源表字段ID。

src_attr_names

Array of strings

源表字段名称数组，只读。

src_attr_id_list

Array of strings

源表字段ID数组，只读，填写String类型替代Long类型。

remark

String

备注。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

create_by

String

创建人。

update_by

String

更新人。

target_attr

Object

目标属性。
表17 MappingSourceTableVO

参数

参数类型

描述

table1_id

String

表1ID，填写String类型替代Long类型。

table2_id

String

表2ID，填写String类型替代Long类型。

table1_name

String

表1名称。

table2_name

String

表2名称。

join_type

String

关联类型。

枚举值：

  • LEFT: 左外连接

  • RIGHT: 右外连接

  • INNER: 内连接

  • FULL: 全连接

join_fields

Array of MappingJoinFieldVO objects

on条件。
表18 MappingJoinFieldVO

参数

参数类型

描述

field1_id

String

属性1ID，填写String类型替代Long类型。

field2_id

String

属性2ID，填写String类型替代Long类型。

field1_name

String

属性1名称。

field2_name

String

属性2名称。
表19 MappingSourceFieldVO

参数

参数类型

描述

target_field_id

String

目标字段ID，当前表的某个字段，填写String类型替代Long类型。

target_field_name

String

目标字段编码。

field_ids

String

来源字段ID，多个ID以逗号分隔。

transform_expression

String

转换表达式。

field_names

Array of strings

来源字段名称列表。

changed

Boolean

字段是否发生变化。
表20 RelationVO

参数

参数类型

描述

id

String

编码，填写String类型替代Long类型。

source_table_id

String

源表ID，填写String类型替代Long类型。

target_table_id

String

目标表ID，填写String类型替代Long类型。

name

String

关系名称。

source_table_name

String

源表名称。

target_table_name

String

目的表名称。

role

String

角色。

tenant_id

String

租户ID。

source_type

String

关系类型，只读。

枚举值：

  • ONE: 表示每条子（父）逻辑实体数据在父（子）逻辑实体中有且只有一条数据与之对应。

  • ZERO_OR_ONE: 表示每条子（父）逻辑实体数据在父（子）逻辑实体中最多有一条数据与之对应。

  • ZERO_OR_N: 表示每条子（父）逻辑实体数据在父（子）逻辑实体中可能有多条数据与之对应。

  • ONE_OR_N: 表示每条子（父）逻辑实体数据在父（子）逻辑实体中至少有一条数据与之对应。

target_type

String

关系类型，只读。

枚举值：

  • ONE: 表示每条子（父）逻辑实体数据在父（子）逻辑实体中有且只有一条数据与之对应。

  • ZERO_OR_ONE: 表示每条子（父）逻辑实体数据在父（子）逻辑实体中最多有一条数据与之对应。

  • ZERO_OR_N: 表示每条子（父）逻辑实体数据在父（子）逻辑实体中可能有多条数据与之对应。

  • ONE_OR_N: 表示每条子（父）逻辑实体数据在父（子）逻辑实体中至少有一条数据与之对应。

create_by

String

创建人。

update_by

String

更新人。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

mappings

Array of RelationMappingVO objects

表属性信息，只读。
表21 RelationMappingVO

参数

参数类型

描述

id

String

编码，填写String类型替代Long类型。

relation_id

String

关系ID，填写String类型替代Long类型。

source_field_id

String

源字段ID，填写String类型替代Long类型。

target_field_id

String

目标字段ID，填写String类型替代Long类型。

source_field_name

String

源表名称。

target_field_name

String

目的表名称。

create_by

String

创建人。

update_by

String

更新人。

create_time

String

创建时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。

update_time

String

更新时间，只读，格式遵循RFC3339，精确到秒，UTC时区，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z。
表22 SelfDefinedFieldVO

参数

参数类型

描述

fd_name_ch

String

自定义项中文名。

fd_name_en

String

自定义项英文名。

not_null

Boolean

是否必填。

fd_value

String

属性值。

状态码： 400

表23 响应Body参数

参数

参数类型

描述

error_code

String

错误码，如DS.6000，请求处理失败。

error_msg

String

错误信息。

data

Object

返回的数据信息。

状态码： 401

表24 响应Body参数

参数

参数类型

描述

error_code

String

错误码，如DS.6000，请求处理失败。

error_msg

String

错误信息。

data

Object

返回的数据信息。

状态码： 403

表25 响应Body参数

参数

参数类型

描述

error_code

String

错误码，如DS.6000，请求处理失败。

error_msg

String

错误信息。

data

Object

返回的数据信息。

请求示例

根据请求体参数更新表级质量规则。

PUT https://{endpoint}/v2/{project_id}/design/1217123755210469376/qualities

{
  "biz_type" : "TABLE_MODEL",
  "dirty_out_switch" : true,
  "dirty_out_database" : "default",
  "dirty_out_prefix" : "err_",
  "dirty_out_suffix" : "_2020_02_28"
}

响应示例

状态码： 200

Success，返回更新后表的全部信息。

{
  "data" : {
    "value" : {
      "id" : "1217123755210469376",
      "model_id" : "873242752312385536",
      "parent_table_id" : null,
      "parent_table_name" : null,
      "parent_table_code" : null,
      "model" : {
        "name" : "test",
        "type" : "THIRD_NF"
      },
      "data_format" : "Parquet",
      "obs_bucket" : null,
      "obs_location" : null,
      "configs" : "{}",
      "table_type" : "MANAGED",
      "owner" : "",
      "tb_name" : "staff_info",
      "dw_id" : "2c9080f07b03db8d017b198a4a20002f",
      "db_name" : "ctz_test",
      "queue_name" : "default",
      "schema" : "",
      "extend_info" : "{\"dirtyOutDatabase\":\"\",\"dirtyOutPrefix\":\"\",\"dirtyOutSuffix\":\"\",\"dirtyOutSwitch\":\"false\"}",
      "tb_guid" : null,
      "tb_id" : "NativeTable-2c9080f07b03db8d017b198a4a20002f-ctz_test-staff_info",
      "logic_tb_name" : "staff_info",
      "logic_tb_guid" : "1ab1a58b-9412-4901-bb80-4ccaaa0580e4",
      "description" : "无",
      "status" : "PUBLISHED",
      "logic_tb_id" : null,
      "biz_catalog_id" : "1012306178602041344",
      "catalog_path" : "工厂/人员管理/人员档案",
      "create_by" : "abc",
      "update_by" : "abc",
      "create_time" : "2022-08-25T10:55:00+08:00",
      "update_time" : "2022-08-25T10:55:45+08:00",
      "approval_info" : {
        "id" : "1012314318533988352",
        "tenant_id" : null,
        "name_ch" : null,
        "name_en" : null,
        "biz_id" : "1012314146584301568",
        "biz_type" : null,
        "biz_info" : null,
        "biz_info_obj" : null,
        "biz_version" : 0,
        "biz_status" : "PUBLISHED",
        "approval_status" : "APPROVED",
        "approval_type" : null,
        "submit_time" : "2022-08-25T10:55:41+08:00",
        "create_by" : null,
        "l1" : null,
        "l2" : null,
        "l3" : null,
        "approval_time" : "2022-08-25T10:55:41+08:00",
        "approver" : "abc",
        "email" : null,
        "msg" : "Fast Approval OK.",
        "directory_path" : null
      },
      "new_biz" : null,
      "attributes" : [ {
        "id" : "1012314146626244608",
        "name_en" : "id",
        "name_ch" : "主键",
        "description" : "",
        "obs_location" : null,
        "create_by" : "abc",
        "update_by" : "abc",
        "data_type" : "STRING",
        "domain_type" : "STRING",
        "data_type_extend" : "",
        "is_primary_key" : true,
        "is_partition_key" : false,
        "is_foreign_key" : false,
        "extend_field" : false,
        "not_null" : true,
        "ordinal" : 1,
        "table_model_id" : null,
        "create_time" : "2022-08-25T10:55:00+08:00",
        "update_time" : "2022-08-25T10:55:00+08:00",
        "tags" : [ {
          "name" : 123
        } ],
        "stand_row_id" : null,
        "stand_row_name" : null,
        "quality_infos" : [ {
          "data_quality_id" : 3
        } ],
        "alias" : "",
        "self_defined_fields" : [ ]
      }, {
        "id" : "1012314146626244609",
        "name_en" : "name",
        "name_ch" : "名称",
        "description" : "",
        "obs_location" : null,
        "create_by" : "abc",
        "update_by" : "abc",
        "data_type" : "STRING",
        "domain_type" : "STRING",
        "data_type_extend" : "",
        "is_primary_key" : false,
        "is_partition_key" : false,
        "is_foreign_key" : false,
        "extend_field" : false,
        "not_null" : false,
        "ordinal" : 2,
        "table_model_id" : null,
        "create_time" : "2022-08-25T10:55:00+08:00",
        "update_time" : "2022-08-25T10:55:00+08:00",
        "tags" : [ {
          "name" : 123
        } ],
        "stand_row_id" : null,
        "stand_row_name" : null,
        "quality_infos" : [ {
          "data_quality_id" : 3
        } ],
        "alias" : "",
        "self_defined_fields" : [ ]
      }, {
        "id" : "1012314146592690176",
        "name_en" : "age",
        "name_ch" : "年龄",
        "description" : "",
        "obs_location" : null,
        "create_by" : "abc",
        "update_by" : "abc",
        "data_type" : "STRING",
        "domain_type" : "STRING",
        "data_type_extend" : "",
        "is_primary_key" : false,
        "is_partition_key" : false,
        "is_foreign_key" : false,
        "extend_field" : false,
        "not_null" : false,
        "ordinal" : 3,
        "table_model_id" : null,
        "create_time" : "2022-08-25T10:55:00+08:00",
        "update_time" : "2022-08-25T10:55:00+08:00",
        "tags" : [ {
          "name" : 123
        } ],
        "stand_row_id" : null,
        "stand_row_name" : null,
        "quality_infos" : [ {
          "data_quality_id" : 3
        } ],
        "alias" : "",
        "self_defined_fields" : [ ]
      } ],
      "mappings" : [ {
        "name" : "test_mapping"
      } ],
      "relations" : [ {
        "name" : "test_relation"
      } ],
      "dw_type" : "DWS",
      "dw_name" : null,
      "l1" : "工厂",
      "l2" : "人员管理",
      "l3" : "人员档案",
      "l1_id" : "1012305751919689728",
      "l2_id" : "1012306048792526848",
      "l3_id" : "1012306178602041344",
      "partition_conf" : null,
      "dlf_task_id" : null,
      "use_recently_partition" : false,
      "reversed" : null,
      "dirty_out_switch" : false,
      "dirty_out_database" : "",
      "dirty_out_prefix" : "",
      "dirty_out_suffix" : "",
      "quality_owner" : null,
      "quality_id" : "1012314332484304897",
      "distribute" : null,
      "distribute_column" : null,
      "is_partition" : false,
      "physical_table" : "CREATE_SUCCESS",
      "technical_asset" : "CREATE_FAILED",
      "business_asset" : "UPDATE_SUCCESS",
      "meta_data_link" : "UPDATE_FAILED",
      "data_quality" : "CREATE_SUCCESS",
      "summary_status" : "SUMMARY_FAILED",
      "alias" : null,
      "self_defined_fields" : null
    }
  }
}

状态码： 400

{
  "error_code" : "DS.60xx",
  "error_msg" : "The user request is illegal."
}

状态码： 401

{
  "error_code" : "DS.60xx",
  "error_msg" : "User authentication failed."
}

状态码： 403

{
  "error_code" : "DS.60xx",
  "error_msg" : "The user does not have permission to call this API."
}

SDK代码示例

SDK代码示例如下。

根据请求体参数更新表级质量规则。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.dataartsstudio.v1.region.DataArtsStudioRegion;
import com.huaweicloud.sdk.dataartsstudio.v1.*;
import com.huaweicloud.sdk.dataartsstudio.v1.model.*;


public class UpdateDesignTableQualitySolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        DataArtsStudioClient client = DataArtsStudioClient.newBuilder()
                .withCredential(auth)
                .withRegion(DataArtsStudioRegion.valueOf("<YOUR REGION>"))
                .build();
        UpdateDesignTableQualityRequest request = new UpdateDesignTableQualityRequest();
        request.withTableId("{table_id}");
        UpdateDesignTableQualityParam body = new UpdateDesignTableQualityParam();
        body.withDirtyOutSuffix("_2020_02_28");
        body.withDirtyOutPrefix("err_");
        body.withDirtyOutDatabase("default");
        body.withDirtyOutSwitch(true);
        body.withBizType(UpdateDesignTableQualityParam.BizTypeEnum.fromValue("TABLE_MODEL"));
        request.withBody(body);
        try {
            UpdateDesignTableQualityResponse response = client.updateDesignTableQuality(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

根据请求体参数更新表级质量规则。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
# coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdataartsstudio.v1.region.dataartsstudio_region import DataArtsStudioRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkdataartsstudio.v1 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = DataArtsStudioClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(DataArtsStudioRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = UpdateDesignTableQualityRequest()
        request.table_id = "{table_id}"
        request.body = UpdateDesignTableQualityParam(
            dirty_out_suffix="_2020_02_28",
            dirty_out_prefix="err_",
            dirty_out_database="default",
            dirty_out_switch=True,
            biz_type="TABLE_MODEL"
        )
        response = client.update_design_table_quality(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

根据请求体参数更新表级质量规则。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    dataartsstudio "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dataartsstudio/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dataartsstudio/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dataartsstudio/v1/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := dataartsstudio.NewDataArtsStudioClient(
        dataartsstudio.DataArtsStudioClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.UpdateDesignTableQualityRequest{}
	request.TableId = "{table_id}"
	dirtyOutSuffixUpdateDesignTableQualityParam:= "_2020_02_28"
	dirtyOutPrefixUpdateDesignTableQualityParam:= "err_"
	dirtyOutDatabaseUpdateDesignTableQualityParam:= "default"
	dirtyOutSwitchUpdateDesignTableQualityParam:= true
	bizTypeUpdateDesignTableQualityParam:= model.GetUpdateDesignTableQualityParamBizTypeEnum().TABLE_MODEL
	request.Body = &model.UpdateDesignTableQualityParam{
		DirtyOutSuffix: &dirtyOutSuffixUpdateDesignTableQualityParam,
		DirtyOutPrefix: &dirtyOutPrefixUpdateDesignTableQualityParam,
		DirtyOutDatabase: &dirtyOutDatabaseUpdateDesignTableQualityParam,
		DirtyOutSwitch: &dirtyOutSwitchUpdateDesignTableQualityParam,
		BizType: &bizTypeUpdateDesignTableQualityParam,
	}
	response, err := client.UpdateDesignTableQuality(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

更多编程语言的SDK代码示例，请参见API Explorer的代码示例页签，可生成自动对应的SDK代码示例。

状态码

状态码

描述

200

Success，返回更新后表的全部信息。

400

BadRequest

401

Unauthorized

403

Forbidden
父主题： 质量规则接口