文档首页/ 数据治理中心 DataArts Studio/ API参考/ 数据架构API/ 汇总表接口/ 更新汇总表 - UpdateDesignAggregationLogicTable
更新时间:2026-09-17 GMT+08:00

更新汇总表 - UpdateDesignAggregationLogicTable

功能介绍

更新汇总表。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

PUT /v2/{project_id}/design/aggregation-logic-tables

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

请求参数

表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参数

参数

是否必选

参数类型

描述

id

否

String

汇总表的唯一系统ID,更新时必填,创建时不须填写,ID字符串。

tb_name

是

String

汇总表英文名称,对应实际的物理表名。

tb_logic_name

是

String

汇总表的中文名,用于展示使用。

l2_id

否

String

主题域ID,只读,创建和更新时无需填写。

l3_id

是

String

汇总表所属主题的ID,必填,ID字符串。

description

否

String

汇总表描述信息。

owner

是

String

汇总表的资产责任人。

secret_type

否

String

密级类型。

枚举值:

  • PUBLIC: 公开

  • SECRET: 秘密

  • CONFIDENTIAL: 机密

  • SUPER_SECRET: 绝密

apply_bg

否

String

适用bg。

queue_name

否

String

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

dw_id

是

String

汇总表所在的数据连接ID,为32位十六进制数字。

db_name

是

String

汇总表所在的数据库名。

schema

否

String

汇总表所在的Schema名,DWS类型必须填写。

dw_name

否

String

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

status

否

String

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

枚举值:

  • DRAFT: 草稿

  • PUBLISH_DEVELOPING: 发布待审核

  • PUBLISHED: 已发布

  • OFFLINE_DEVELOPING: 下线待审核

  • OFFLINE: 已下线

  • REJECT: 已驳回

tb_guid

否

String

表发布后,创建的数据目录技术资产guid,只读,创建和更新时无需填写。

tb_logic_guid

否

String

表发布后,创建的数据目录业务资产guid,只读,创建和更新时无需填写。

dw_type

是

String

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

l1

否

String

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

l2

否

String

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

l3

否

String

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

approval_info

否

ApprovalVO object

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

new_biz

否

BizVersionManageVO object

业务版本管理,只读。

dimension_group

否

String

颗粒度ID。

time_period

否

AggregationLogicTableAttributeVO object

汇总表时间周期属性信息。

table_attributes

否

Array of AggregationLogicTableAttributeVO objects

汇总表属性信息,依据attribute_type判断类型。

distribute

否

String

DISTRIBUTE BY [HASH(column)|REPLICATION]。

枚举值:

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

  • REPLICATION: 表的每一行存在所有数据节点(DN)中,即每个数据节点都有完整的表数据

distribute_column

否

String

DISTRIBUTE BY HASH column.

compression

否

String

DWS数据压缩等级,列压缩等级为no/low/middle/high,行压缩等级为no/yes。

枚举值:

  • "NO": 不压缩

  • "YES": 压缩

  • "LOW": 低等级压缩

  • "MIDDLE": 中等级压缩

  • "HIGH": 高等级压缩

obs_location

否

String

外表路径。

pre_combine_field

否

String

版本字段。

table_type

否

String

表类型。

枚举值:

  • TABLE_MODEL: 关系模型(逻辑模型/物理模型)

  • AGGREGATION_LOGIC_TABLE: 汇总表

  • FACT_LOGIC_TABLE: 事实表

  • DIMENSION_LOGIC_TABLE: 维度表

dlf_task_id

否

String

DLF作业ID。

quality_id

否

String

质量ID,ID字符串。

partition_conf

否

String

分区表达式。

dirty_out_switch

否

Boolean

异常数据输出开关。

dirty_out_database

否

String

异常数据输出库。

dirty_out_prefix

否

String

异常表前缀。

dirty_out_suffix

否

String

异常表后缀。

alias

否

String

别名。

configs

否

String

其他配置。

self_defined_fields

否

Array of SelfDefinedFieldVO objects

自定义项。

api_id

否

String

API ID。

sql

否

String

汇总表绑定的SQL。

model_id

否

String

所属模型ID,ID字符串。

model

否

WorkspaceVO object

模型信息。

表4 ApprovalVO

参数

是否必选

参数类型

描述

id

否

String

审批单ID,ID字符串。

tenant_id

否

String

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

name_ch

否

String

业务中文名。

name_en

否

String

业务英文名。

biz_id

否

String

业务ID,ID字符串。

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

目录树。

表5 BizVersionManageVO

参数

是否必选

参数类型

描述

id

否

String

ID信息,ID字符串。

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,ID字符串。

biz_info

否

String

业务对象信息。

status

否

String

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

枚举值:

  • DRAFT: 草稿

  • PUBLISH_DEVELOPING: 发布待审核

  • PUBLISHED: 已发布

  • OFFLINE_DEVELOPING: 下线待审核

  • OFFLINE: 已下线

  • REJECT: 已驳回

表6 AggregationLogicTableAttributeVO

参数

是否必选

参数类型

描述

id

否

String

编码,ID字符串。

aggregation_logic_table_id

否

String

所属汇总表ID,ID字符串。

ordinal

否

Integer

序号。

name_en

是

String

字段名。

name_ch

是

String

业务属性。

attribute_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: 时间限定

is_primary_key

是

Boolean

是否主键。

is_partition_key

是

Boolean

是否分区键。

not_null

否

Boolean

是否不为空。

description

否

String

描述。

data_type

是

String

字段类型。

枚举值:

  • BIGINT: 长整型

  • STRING: 字符类型

  • DATE: 日期类型

data_type_extend

否

String

数据类型扩展字段。

ref_id

否

String

属性关联对象的id

stand_row_id

否

String

关联的数据标准的ID,ID字符串。

alias

否

String

别名。

表7 SelfDefinedFieldVO

参数

是否必选

参数类型

描述

fd_name_ch

否

String

自定义项中文名。

fd_name_en

否

String

自定义项英文名。

not_null

否

Boolean

是否必填。

fd_value

否

String

属性值。

表8 WorkspaceVO

参数

是否必选

参数类型

描述

id

否

String

编号,ID字符串。

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_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,数字字母下划线组成,字母开头

响应参数

状态码:200

表9 响应Body参数

参数

参数类型

描述

data

Object

返回的数据信息。

状态码:400

表10 响应Body参数

参数

参数类型

描述

error_code

String

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

error_msg

String

错误信息。

data

Object

返回的数据信息。

状态码:401

表11 响应Body参数

参数

参数类型

描述

error_code

String

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

error_msg

String

错误信息。

data

Object

返回的数据信息。

状态码:403

表12 响应Body参数

参数

参数类型

描述

error_code

String

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

error_msg

String

错误信息。

data

Object

返回的数据信息。

请求示例

根据入参,修改汇总表信息。

PUT https://{endpoint}/v2/{project_id}/design/aggregation-logic-tables

{
  "tb_name" : "test_create_aggregation_logic_table",
  "tb_logic_name" : "test_create_aggregation_logic_table",
  "alias" : "",
  "dimension_group" : "0",
  "secret_type" : "PUBLIC",
  "apply_bg" : "",
  "l3_id" : "1105525024175058944",
  "description" : "无",
  "owner" : "autotest_tics",
  "dw_type" : "DWS",
  "dw_id" : "8259af52bd294f98920ebce75a426391",
  "db_name" : "bi",
  "schema" : "",
  "queue_name" : "default",
  "self_defined_fields" : [ {
    "fd_name_ch" : "aaa",
    "fd_name_en" : "aaa",
    "not_null" : false,
    "fd_value" : ""
  } ],
  "configs" : "{}",
  "table_type" : "MANAGED",
  "obs_location" : "",
  "table_attributes" : [ {
    "id" : "1227937502644600832",
    "name_ch" : "col_aa",
    "name_en" : "col_aa",
    "ordinal" : 1,
    "is_primary_key" : false,
    "is_partition_key" : false,
    "not_null" : false,
    "description" : "",
    "data_type" : "BIGINT",
    "data_type_extend" : "",
    "stand_row_id" : null,
    "stand_row_name" : null,
    "ref_id" : null,
    "ref_name_ch" : null,
    "quality_infos" : [ {
      "data_quality_id" : "1227937502644600833"
    } ],
    "secrecy_levels" : [ {
      "name" : "secrecy_level_name"
    } ]
  } ],
  "id" : "1227937502401331200",
  "sql" : "",
  "dirty_out_switch" : false,
  "dirty_out_database" : "",
  "dirty_out_prefix" : "",
  "dirty_out_suffix" : "",
  "partition_conf" : null
}

响应示例

状态码:200

Success,返回data数据是AggregationLogicTableVO。

{
  "data" : {
    "value" : {
      "id" : "1227937502401331200",
      "tb_name" : "test_create_aggregation_logic_table",
      "tb_logic_name" : "test_create_aggregation_logic_table",
      "l1_id" : null,
      "l2_id" : null,
      "l3_id" : "1105525024175058944",
      "description" : "无",
      "owner" : "autotest_tics",
      "create_by" : "test_user",
      "queue_name" : "default",
      "dw_id" : "8259af52bd294f98920ebce75a426391",
      "db_name" : "bi",
      "tb_id" : null,
      "schema" : "",
      "dw_name" : null,
      "status" : "DRAFT",
      "tb_guid" : null,
      "tb_logic_guid" : null,
      "dw_type" : "DWS",
      "l1" : null,
      "l2" : null,
      "l3" : null,
      "create_time" : "2024-04-11T11:05:15+08:00",
      "update_time" : "2024-04-11T11:28:17.101+08:00",
      "approval_info" : null,
      "new_biz" : null,
      "dimension_group" : "0",
      "group_name" : null,
      "group_code" : null,
      "time_period" : null,
      "table_attributes" : [ {
        "id" : "1227937502644600832",
        "aggregation_logic_table_id" : null,
        "ordinal" : 1,
        "name_en" : "col_aa",
        "name_ch" : "col_aa",
        "attribute_type" : null,
        "is_primary_key" : false,
        "is_partition_key" : false,
        "not_null" : false,
        "secrecy_levels" : null,
        "description" : "",
        "data_type" : "BIGINT",
        "domain_type" : "NUMBER",
        "data_type_extend" : "",
        "ref_id" : null,
        "ref_name_ch" : null,
        "ref_name_en" : null,
        "stand_row_id" : null,
        "stand_row_name" : null,
        "quality_infos" : [ ],
        "alias" : null
      }, {
        "id" : "1227937502644600833",
        "aggregation_logic_table_id" : null,
        "ordinal" : 2,
        "name_en" : "col_bb",
        "name_ch" : "col_bb",
        "attribute_type" : null,
        "is_primary_key" : false,
        "is_partition_key" : false,
        "not_null" : false,
        "secrecy_levels" : null,
        "description" : "",
        "data_type" : "BIGINT",
        "domain_type" : "NUMBER",
        "data_type_extend" : "",
        "ref_id" : null,
        "ref_name_ch" : null,
        "ref_name_en" : null,
        "stand_row_id" : null,
        "stand_row_name" : null,
        "quality_infos" : [ ],
        "alias" : null
      }, {
        "id" : null,
        "aggregation_logic_table_id" : null,
        "ordinal" : 3,
        "name_en" : "col_cc",
        "name_ch" : "col_cc",
        "attribute_type" : null,
        "is_primary_key" : false,
        "is_partition_key" : false,
        "not_null" : false,
        "secrecy_levels" : null,
        "description" : "",
        "data_type" : "BIGINT",
        "domain_type" : "NUMBER",
        "data_type_extend" : "",
        "ref_id" : null,
        "ref_name_ch" : null,
        "ref_name_en" : null,
        "stand_row_id" : null,
        "stand_row_name" : null,
        "quality_infos" : null,
        "alias" : null
      } ],
      "physical_table" : null,
      "dev_physical_table" : null,
      "technical_asset" : null,
      "business_asset" : null,
      "meta_data_link" : null,
      "data_quality" : null,
      "dlf_task" : null,
      "publish_to_dlm" : null,
      "summary_status" : null,
      "distribute" : null,
      "distribute_column" : null,
      "compression" : null,
      "obs_location" : null,
      "pre_combine_field" : null,
      "table_type" : "MANAGED",
      "dlf_task_id" : null,
      "quality_id" : null,
      "reversed" : false,
      "table_version" : 0,
      "partition_conf" : null,
      "dirty_out_switch" : false,
      "dirty_out_database" : "",
      "dirty_out_prefix" : "",
      "dirty_out_suffix" : "",
      "alias" : "",
      "configs" : "{}",
      "self_defined_fields" : [ {
        "fd_name_ch" : "aaa",
        "fd_name_en" : "aaa",
        "not_null" : false,
        "fd_value" : ""
      } ],
      "api_id" : null,
      "dev_version" : null,
      "prod_version" : null,
      "dev_version_name" : null,
      "prod_version_name" : null,
      "env_type" : null,
      "sql" : ""
    }
  }
}

状态码:400

BadRequest

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

状态码:401

Unauthorized

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

状态码:403

Forbidden

{
  "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
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
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.*;

import java.util.List;
import java.util.ArrayList;

public class UpdateDesignAggregationLogicTableSolution {

    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();
        UpdateDesignAggregationLogicTableRequest request = new UpdateDesignAggregationLogicTableRequest();
        AggregationLogicTableVO body = new AggregationLogicTableVO();
        List<SelfDefinedFieldVO> listbodySelfDefinedFields = new ArrayList<>();
        listbodySelfDefinedFields.add(
            new SelfDefinedFieldVO()
                .withFdNameCh("aaa")
                .withFdNameEn("aaa")
                .withNotNull(false)
                .withFdValue("")
        );
        List<QualityInfoVO> listTableAttributesQualityInfos = new ArrayList<>();
        listTableAttributesQualityInfos.add(
            new QualityInfoVO()
                .withDataQualityId("1227937502644600833")
        );
        List<SecrecyLevelVO> listTableAttributesSecrecyLevels = new ArrayList<>();
        listTableAttributesSecrecyLevels.add(
            new SecrecyLevelVO()
                .withName("secrecy_level_name")
        );
        List<AggregationLogicTableAttributeVO> listbodyTableAttributes = new ArrayList<>();
        listbodyTableAttributes.add(
            new AggregationLogicTableAttributeVO()
                .withId("1227937502644600832")
                .withOrdinal(1)
                .withNameEn("col_aa")
                .withNameCh("col_aa")
                .withIsPrimaryKey(false)
                .withIsPartitionKey(false)
                .withSecrecyLevels(listTableAttributesSecrecyLevels)
                .withNotNull(false)
                .withDescription("")
                .withDataType("BIGINT")
                .withDataTypeExtend("")
                .withQualityInfos(listTableAttributesQualityInfos)
        );
        body.withSql("");
        body.withSelfDefinedFields(listbodySelfDefinedFields);
        body.withConfigs("{}");
        body.withAlias("");
        body.withDirtyOutSuffix("");
        body.withDirtyOutPrefix("");
        body.withDirtyOutDatabase("");
        body.withDirtyOutSwitch(false);
        body.withTableType("MANAGED");
        body.withObsLocation("");
        body.withTableAttributes(listbodyTableAttributes);
        body.withDimensionGroup("0");
        body.withDwType("DWS");
        body.withSchema("");
        body.withDbName("bi");
        body.withDwId("8259af52bd294f98920ebce75a426391");
        body.withQueueName("default");
        body.withApplyBg(AggregationLogicTableVO.ApplyBgEnum.fromValue(""));
        body.withSecretType(AggregationLogicTableVO.SecretTypeEnum.fromValue("PUBLIC"));
        body.withOwner("autotest_tics");
        body.withDescription("无");
        body.withL3Id("1105525024175058944");
        body.withTbLogicName("test_create_aggregation_logic_table");
        body.withTbName("test_create_aggregation_logic_table");
        body.withId("1227937502401331200");
        request.withBody(body);
        try {
            UpdateDesignAggregationLogicTableResponse response = client.updateDesignAggregationLogicTable(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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
# 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 = UpdateDesignAggregationLogicTableRequest()
        listSelfDefinedFieldsbody = [
            SelfDefinedFieldVO(
                fd_name_ch="aaa",
                fd_name_en="aaa",
                not_null=False,
                fd_value=""
            )
        ]
        listQualityInfosTableAttributes = [
            QualityInfoVO(
                data_quality_id="1227937502644600833"
            )
        ]
        listSecrecyLevelsTableAttributes = [
            SecrecyLevelVO(
                name="secrecy_level_name"
            )
        ]
        listTableAttributesbody = [
            AggregationLogicTableAttributeVO(
                id="1227937502644600832",
                ordinal=1,
                name_en="col_aa",
                name_ch="col_aa",
                is_primary_key=False,
                is_partition_key=False,
                secrecy_levels=listSecrecyLevelsTableAttributes,
                not_null=False,
                description="",
                data_type="BIGINT",
                data_type_extend="",
                quality_infos=listQualityInfosTableAttributes
            )
        ]
        request.body = AggregationLogicTableVO(
            sql="",
            self_defined_fields=listSelfDefinedFieldsbody,
            configs="{}",
            alias="",
            dirty_out_suffix="",
            dirty_out_prefix="",
            dirty_out_database="",
            dirty_out_switch=False,
            table_type="MANAGED",
            obs_location="",
            table_attributes=listTableAttributesbody,
            dimension_group="0",
            dw_type="DWS",
            schema="",
            db_name="bi",
            dw_id="8259af52bd294f98920ebce75a426391",
            queue_name="default",
            apply_bg="",
            secret_type="PUBLIC",
            owner="autotest_tics",
            description="无",
            l3_id="1105525024175058944",
            tb_logic_name="test_create_aggregation_logic_table",
            tb_name="test_create_aggregation_logic_table",
            id="1227937502401331200"
        )
        response = client.update_design_aggregation_logic_table(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
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
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, err := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        SafeBuild()

    if err != nil {
        fmt.Println(err)
        return
    }

    hcClient, err := dataartsstudio.DataArtsStudioClientBuilder().
         WithRegion(region.ValueOf("<YOUR REGION>")).
         WithCredential(auth).
         SafeBuild()


    if err != nil {
        fmt.Println(err)
        return
    }

    client := dataartsstudio.NewDataArtsStudioClient(hcClient)

    request := &model.UpdateDesignAggregationLogicTableRequest{}
	fdNameChSelfDefinedFields:= "aaa"
	fdNameEnSelfDefinedFields:= "aaa"
	notNullSelfDefinedFields:= false
	fdValueSelfDefinedFields:= ""
	var listSelfDefinedFieldsbody = []model.SelfDefinedFieldVo{
        {
            FdNameCh: &fdNameChSelfDefinedFields,
            FdNameEn: &fdNameEnSelfDefinedFields,
            NotNull: &notNullSelfDefinedFields,
            FdValue: &fdValueSelfDefinedFields,
        },
    }
	var listQualityInfosTableAttributes = []model.QualityInfoVo{
        {
            DataQualityId: "1227937502644600833",
        },
    }
	var listSecrecyLevelsTableAttributes = []model.SecrecyLevelVo{
        {
            Name: "secrecy_level_name",
        },
    }
	idTableAttributes:= "1227937502644600832"
	ordinalTableAttributes:= int32(1)
	notNullTableAttributes:= false
	descriptionTableAttributes:= ""
	dataTypeExtendTableAttributes:= ""
	var listTableAttributesbody = []model.AggregationLogicTableAttributeVo{
        {
            Id: &idTableAttributes,
            Ordinal: &ordinalTableAttributes,
            NameEn: "col_aa",
            NameCh: "col_aa",
            IsPrimaryKey: false,
            IsPartitionKey: false,
            SecrecyLevels: &listSecrecyLevelsTableAttributes,
            NotNull: &notNullTableAttributes,
            Description: &descriptionTableAttributes,
            DataType: "BIGINT",
            DataTypeExtend: &dataTypeExtendTableAttributes,
            QualityInfos: &listQualityInfosTableAttributes,
        },
    }
	sqlAggregationLogicTableVo:= ""
	configsAggregationLogicTableVo:= "{}"
	aliasAggregationLogicTableVo:= ""
	dirtyOutSuffixAggregationLogicTableVo:= ""
	dirtyOutPrefixAggregationLogicTableVo:= ""
	dirtyOutDatabaseAggregationLogicTableVo:= ""
	dirtyOutSwitchAggregationLogicTableVo:= false
	tableTypeAggregationLogicTableVo:= "MANAGED"
	obsLocationAggregationLogicTableVo:= ""
	dimensionGroupAggregationLogicTableVo:= "0"
	schemaAggregationLogicTableVo:= ""
	queueNameAggregationLogicTableVo:= "default"
	applyBgApplyBg:= model.GetApplyBgEnumApplyBgEnum().EMPTY
	secretTypeSecretType:= model.GetSecretTypeEnumSecretTypeEnum().PUBLIC
	descriptionAggregationLogicTableVo:= "无"
	idAggregationLogicTableVo:= "1227937502401331200"
	request.Body = &model.AggregationLogicTableVo{
		Sql: &sqlAggregationLogicTableVo,
		SelfDefinedFields: &listSelfDefinedFieldsbody,
		Configs: &configsAggregationLogicTableVo,
		Alias: &aliasAggregationLogicTableVo,
		DirtyOutSuffix: &dirtyOutSuffixAggregationLogicTableVo,
		DirtyOutPrefix: &dirtyOutPrefixAggregationLogicTableVo,
		DirtyOutDatabase: &dirtyOutDatabaseAggregationLogicTableVo,
		DirtyOutSwitch: &dirtyOutSwitchAggregationLogicTableVo,
		TableType: &tableTypeAggregationLogicTableVo,
		ObsLocation: &obsLocationAggregationLogicTableVo,
		TableAttributes: &listTableAttributesbody,
		DimensionGroup: &dimensionGroupAggregationLogicTableVo,
		DwType: "DWS",
		Schema: &schemaAggregationLogicTableVo,
		DbName: "bi",
		DwId: "8259af52bd294f98920ebce75a426391",
		QueueName: &queueNameAggregationLogicTableVo,
		ApplyBg: &applyBgApplyBg,
		SecretType: &secretTypeSecretType,
		Owner: "autotest_tics",
		Description: &descriptionAggregationLogicTableVo,
		L3Id: "1105525024175058944",
		TbLogicName: "test_create_aggregation_logic_table",
		TbName: "test_create_aggregation_logic_table",
		Id: &idAggregationLogicTableVo,
	}
	response, err := client.UpdateDesignAggregationLogicTable(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

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

状态码

状态码

描述

200

Success,返回data数据是AggregationLogicTableVO。

400

BadRequest

401

Unauthorized

403

Forbidden