标准落标映射管理SKILL

更新时间:
复制 MD 格式

您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,管理资产字段与数据标准之间的落标映射关系,包括查询、批量创建、置为无效与删除映射。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。

功能介绍

标准落标映射管理能力支持您通过自然语言指令,把资产字段或指标与数据标准建立映射关系,这是标准落地监控(落标)的前提。映射分为两类:有效映射表示字段应遵循该标准并参与落标监控;无效映射表示明确排除的关系,用于防止后续误映射。您可以双向查询映射现状、批量创建映射、将有效映射置为无效,以及删除有效或无效映射。

适用场景:

  • 查询某个字段映射了哪些数据标准,或某个标准落到了哪些字段。

  • 批量为一批字段建立与某数据标准的有效映射,完成落标。

  • 将已建立的映射置为无效,明确排除某字段不应映射某标准。

  • 删除有效或无效映射,解除已有的落标关系。

说明

能力限制:仅「已生效」的数据标准可建立有效映射;批量操作的资产GUID单次上限为1000,超限需分批提交;映射以资产GUID为主键,若只知道表名或字段名需先解析为GUID;当待建关系已在无效映射列表中时,默认策略会将其转为有效映射,需确认冲突处理方式。

使用前提

  • 当前账号具备数据标准与资产相关的管理权限。

  • 目标数据标准已发布为「已生效」状态,这是建立有效映射的前提。

  • 已获取要映射的资产GUID(字段级GUID)。若只知道表名或字段名,可先通过资产查询能力将其解析为GUID。

使用示例

您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:

  • 把订单表的amount和status两个字段映射到「订单金额标准」。

  • 查一下订单表的amount字段映射了哪些数据标准。

  • 把用户表的remark字段与「客户编码标准」的映射置为无效,它不该映射这个标准。

交互步骤:

  1. 您发出指令后,Agent会先与您确认目标数据标准与要映射的资产字段。

  2. 若您只提供表名或字段名,Agent通常会先将其解析为资产GUID。

  3. 建立映射前,Agent通常会先查询映射现状以避免重复创建;若待建关系已在无效映射列表中,Agent会与您确认是转为有效映射还是保留无效并跳过。

  4. 正式提交前,Agent通常会复述即将执行的变更(目标标准、字段数量、映射类型、冲突策略)供您确认。

  5. 您确认后,Agent提交操作,并回查映射结果与成功、失败明细。

执行结果

操作完成后,您可以获得以下结果:

  • 返回内容:批量创建会返回成功条数与失败的GUID清单;查询会返回字段与标准的映射关系,含标准名称、编码等快照信息。

  • 完成状态:命令返回成功表示请求已受理,批量操作中可能存在部分GUID失败。

  • 查看与验证:您可以在Dataphin的资产或标准落标相关页面查看字段与标准的映射关系,确认与预期一致。

说明

命令行返回成功仅表示请求已受理,最终请以Dataphin界面显示的实际结果为准。

附录:输入信息

以下为管理标准落标映射时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。

信息项

是否必填

说明

示例

租户ID

是

目标Dataphin租户的ID,为19位数字。

1234567890123456789

数据标准ID

是

目标数据标准的ID,须为已生效的标准。

——

资产GUID列表

条件必填

建立映射时提供的字段级资产GUID,单次上限1000。

——

映射类型

否

有效映射(参与落标监控)或无效映射(明确排除关系),默认为有效映射。

有效映射

无效映射冲突策略

否

待建关系已在无效映射列表时,选择转为有效映射或保留无效并跳过;默认为转为有效映射。

保留并跳过

范围GUID

条件必填

置无效或删除时,按资产GUID或归属资产(表)GUID圈定范围,单次上限1000。

——

资产类型

否

查询映射时指定的资产类型:字段或指标。

字段