您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,更新已有数据标准的属性值、描述、负责人与监控配置。本文为您介绍该能力的功能、使用前提与使用示例,并在附录中提供输入信息清单供参考。
功能介绍
更新数据标准能力支持您通过自然语言指令,修改一条已有数据标准,包括调整描述、负责人、生效时间,或新增、修改、删除其监控配置(元数据监控与质量监控),也可切换监控类型。该能力用于在标准创建之后持续修订标准内容与校验规则。
适用场景:
-
修改已有数据标准的描述、负责人或生效时间。
-
为已有标准新增、修改或删除元数据监控、质量监控规则。
-
调整质量监控的阈值条件,或在元数据监控与质量监控之间切换类型。
能力限制:更新以标准当前配置为基础,标准属性值为整体覆盖语义,即使只改一个属性也须带上其余属性值,否则必填属性会变空而报错;监控配置的增改删由每条监控的Id决定(不传Id为新增、传现有Id为更新、省略现有Id为删除),漏列已有Id会触发误删;标准编码、名称等属性值只能通过标准模板引用的属性值列表传入,放到监控配置中无效。
使用前提
-
当前账号具备数据标准相关的管理权限。
-
目标数据标准已存在,且已知晓其标准ID与当前状态。
-
已准备好要修改的属性值或监控配置;更新时会以标准当前配置为基础,需保留不修改的部分。
使用示例
您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:
-
把客户编码标准的描述改成「客户唯一编码规范」。
-
给订单金额标准的质量监控把阈值上限从10000改成50000。
-
给客户编码标准新增一条元数据监控,校验该字段必须填写描述。
交互步骤:
-
您发出更新指令后,Agent会先与您确认目标标准及要修改的内容。
-
Agent通常会先拉取标准当前的全量配置(属性值与监控规则),在其基础上做增删改,避免整体覆盖时丢失或误删已有内容。
-
正式提交前,Agent通常会复述即将更新的完整配置(属性值、监控规则、影响范围)供您确认。
-
您确认后,Agent提交更新,并回查标准配置是否与预期一致。
附录:输入信息
以下为更新数据标准时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。
|
信息项 |
是否必填 |
说明 |
示例 |
|
租户ID |
是 |
目标Dataphin租户的ID,为19位数字。 |
1234567890123456789 |
|
标准ID |
是 |
待更新的数据标准的ID。 |
—— |
|
标准状态 |
是 |
标准的当前状态,如已生效、草稿;不确定时可先查询标准现状后回填。 |
已生效 |
|
标准模板及属性值 |
是 |
标准引用的模板及其属性值(标准编码、标准名称、数据类型等)。属性值为整体覆盖,改一个属性也须带上其余属性值。 |
基础字段标准模板、标准编码CUSTOMER_CODE |
|
标准集 |
是 |
标准所属的标准集。 |
客户信息标准集 |
|
监控配置 |
否 |
标准的元数据监控或质量监控规则。每条监控的Id决定新增(不传Id)、更新(传现有Id)或删除(省略现有Id)。 |
金额大于等于0且小于10000 |
|
生效时间配置 |
否 |
标准的生效时间;按时间段生效时需同时提供开始时间与结束时间。 |
—— |
|
描述 |
否 |
数据标准的补充说明。 |
客户唯一编码规范 |
|
负责人 |
否 |
标准负责人,不指定时默认为当前用户。 |
—— |
|
是否重新生成标准编码 |
否 |
是否由平台按编码规则重新生成标准编码;开启后传入的标准编码将被忽略。 |
否 |