您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,管理资产字段与数据标准之间的落标映射关系,包括查询、批量创建、置为无效与删除映射。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。
功能介绍
标准落标映射管理能力支持您通过自然语言指令,把资产字段或指标与数据标准建立映射关系,这是标准落地监控(落标)的前提。映射分为两类:有效映射表示字段应遵循该标准并参与落标监控;无效映射表示明确排除的关系,用于防止后续误映射。您可以双向查询映射现状、批量创建映射、将有效映射置为无效,以及删除有效或无效映射。
适用场景:
-
查询某个字段映射了哪些数据标准,或某个标准落到了哪些字段。
-
批量为一批字段建立与某数据标准的有效映射,完成落标。
-
将已建立的映射置为无效,明确排除某字段不应映射某标准。
-
删除有效或无效映射,解除已有的落标关系。
能力限制:仅「已生效」的数据标准可建立有效映射;批量操作的资产GUID单次上限为1000,超限需分批提交;映射以资产GUID为主键,若只知道表名或字段名需先解析为GUID;当待建关系已在无效映射列表中时,默认策略会将其转为有效映射,需确认冲突处理方式。
使用前提
-
当前账号具备数据标准与资产相关的管理权限。
-
目标数据标准已发布为「已生效」状态,这是建立有效映射的前提。
-
已获取要映射的资产GUID(字段级GUID)。若只知道表名或字段名,可先通过资产查询能力将其解析为GUID。
使用示例
您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:
-
把订单表的amount和status两个字段映射到「订单金额标准」。
-
查一下订单表的amount字段映射了哪些数据标准。
-
把用户表的remark字段与「客户编码标准」的映射置为无效,它不该映射这个标准。
交互步骤:
-
您发出指令后,Agent会先与您确认目标数据标准与要映射的资产字段。
-
若您只提供表名或字段名,Agent通常会先将其解析为资产GUID。
-
建立映射前,Agent通常会先查询映射现状以避免重复创建;若待建关系已在无效映射列表中,Agent会与您确认是转为有效映射还是保留无效并跳过。
-
正式提交前,Agent通常会复述即将执行的变更(目标标准、字段数量、映射类型、冲突策略)供您确认。
-
您确认后,Agent提交操作,并回查映射结果与成功、失败明细。
执行结果
操作完成后,您可以获得以下结果:
-
返回内容:批量创建会返回成功条数与失败的GUID清单;查询会返回字段与标准的映射关系,含标准名称、编码等快照信息。
-
完成状态:命令返回成功表示请求已受理,批量操作中可能存在部分GUID失败。
-
查看与验证:您可以在Dataphin的资产或标准落标相关页面查看字段与标准的映射关系,确认与预期一致。
命令行返回成功仅表示请求已受理,最终请以Dataphin界面显示的实际结果为准。
附录:输入信息
以下为管理标准落标映射时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。
|
信息项 |
是否必填 |
说明 |
示例 |
|
租户ID |
是 |
目标Dataphin租户的ID,为19位数字。 |
1234567890123456789 |
|
数据标准ID |
是 |
目标数据标准的ID,须为已生效的标准。 |
—— |
|
资产GUID列表 |
条件必填 |
建立映射时提供的字段级资产GUID,单次上限1000。 |
—— |
|
映射类型 |
否 |
有效映射(参与落标监控)或无效映射(明确排除关系),默认为有效映射。 |
有效映射 |
|
无效映射冲突策略 |
否 |
待建关系已在无效映射列表时,选择转为有效映射或保留无效并跳过;默认为转为有效映射。 |
保留并跳过 |
|
范围GUID |
条件必填 |
置无效或删除时,按资产GUID或归属资产(表)GUID圈定范围,单次上限1000。 |
—— |
|
资产类型 |
否 |
查询映射时指定的资产类型:字段或指标。 |
字段 |