数据标准码表管理SKILL

更新时间:
复制 MD 格式

您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,创建、查询、更新和删除数据标准码表,并维护码表中的码值。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。

功能介绍

数据标准码表管理能力支持您通过自然语言指令,维护一组「代码值+代码名称」的枚举字典(如城市码表、订单状态码表)。码表可供数据标准的值域引用,是标准化治理中沉淀枚举取值的核心产物。您可以创建码表、查询码表详情、更新码值以及删除码表。

适用场景:

  • 新建一张码表并录入码值,如订单状态码表包含待支付、已支付、已退款。

  • 维护已有码表的码值,新增、修改或删除其中的代码值。

  • 查询某张码表的名称、编码与完整码值清单。

  • 删除不再使用的码表。

说明

能力限制:码表更新为整体覆盖语义,即每次提交会替换全部码值,需在原有码值基础上增删改后整体回传;码表编码在租户内唯一、名称在归属目录内唯一;每张码表最多10000个码值;查询按码表ID进行,没有分页列出全部码表的命令;被数据标准值域引用的码表需先解除引用才能删除。

使用前提

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

  • 已准备好码表名称、码表编码以及要录入的码值清单(每个码值含代码值与代码名称,均不超过64字符,代码值在码表内唯一)。

  • 执行查询、更新或删除时,已知晓目标码表的ID(可在Dataphin控制台「标准-标准代码」页获取,或从创建码表时的返回结果中记录)。

使用示例

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

  • 创建一张订单状态码表,编码为ORDER_STATUS,包含待支付、已支付、已退款三个码值。

  • 给城市码表新增一个码值,代码值为330100,代码名称为杭州市。

  • 查一下订单状态码表的详情,把码值清单列给我。

交互步骤:

  1. 您发出指令后,Agent会先与您确认码表名称、编码及码值清单。

  2. 若为更新码值,Agent通常会先查询码表当前的全量码值,在其基础上增删改后再整体回传,避免覆盖时丢失原有码值。

  3. 正式提交前,Agent通常会复述即将执行的变更(目标码表、码值清单、影响范围)供您确认。

  4. 您确认后,Agent提交操作,并回查码表的名称、编码与码值数是否与预期一致。

执行结果

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

  • 返回内容:创建成功会返回新码表的ID;查询会返回码表的名称、编码、描述与完整码值清单。

  • 完成状态:命令返回成功表示请求已被受理。

  • 查看与验证:您可以在Dataphin控制台「标准-标准代码(码表)」页查看码表及其码值,确认与预期一致。

说明

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

附录:输入信息

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

信息项

是否必填

说明

示例

租户ID

是

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

1234567890123456789

码表名称

条件必填

码表的名称,在归属目录内唯一;创建与更新时需提供。

订单状态码表

码表编码

条件必填

码表的编码,在租户内唯一,建议采用大写下划线风格;创建与更新时需提供。

ORDER_STATUS

码表ID

条件必填

目标码表的ID;查询、更新、删除时需提供,可从控制台获取或从创建返回结果中记录。

——

码值清单

否

码表的代码值列表。每个码值含代码值与代码名称(均必填、不超过64字符、代码值在码表内唯一),可选英文名与描述。

待支付、已支付、已退款

归属目录

否

码表挂载的目录路径。

/标准/码表

描述

否

码表的补充说明。

订单状态枚举字典

负责人

否

码表负责人,不指定时默认为当前用户。

——