您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,创建、查询、更新和删除数据标准码表,并维护码表中的码值。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。
功能介绍
数据标准码表管理能力支持您通过自然语言指令,维护一组「代码值+代码名称」的枚举字典(如城市码表、订单状态码表)。码表可供数据标准的值域引用,是标准化治理中沉淀枚举取值的核心产物。您可以创建码表、查询码表详情、更新码值以及删除码表。
适用场景:
-
新建一张码表并录入码值,如订单状态码表包含待支付、已支付、已退款。
-
维护已有码表的码值,新增、修改或删除其中的代码值。
-
查询某张码表的名称、编码与完整码值清单。
-
删除不再使用的码表。
能力限制:码表更新为整体覆盖语义,即每次提交会替换全部码值,需在原有码值基础上增删改后整体回传;码表编码在租户内唯一、名称在归属目录内唯一;每张码表最多10000个码值;查询按码表ID进行,没有分页列出全部码表的命令;被数据标准值域引用的码表需先解除引用才能删除。
使用前提
-
当前账号具备数据标准相关的管理权限。
-
已准备好码表名称、码表编码以及要录入的码值清单(每个码值含代码值与代码名称,均不超过64字符,代码值在码表内唯一)。
-
执行查询、更新或删除时,已知晓目标码表的ID(可在Dataphin控制台「标准-标准代码」页获取,或从创建码表时的返回结果中记录)。
使用示例
您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:
-
创建一张订单状态码表,编码为ORDER_STATUS,包含待支付、已支付、已退款三个码值。
-
给城市码表新增一个码值,代码值为330100,代码名称为杭州市。
-
查一下订单状态码表的详情,把码值清单列给我。
交互步骤:
-
您发出指令后,Agent会先与您确认码表名称、编码及码值清单。
-
若为更新码值,Agent通常会先查询码表当前的全量码值,在其基础上增删改后再整体回传,避免覆盖时丢失原有码值。
-
正式提交前,Agent通常会复述即将执行的变更(目标码表、码值清单、影响范围)供您确认。
-
您确认后,Agent提交操作,并回查码表的名称、编码与码值数是否与预期一致。
执行结果
操作完成后,您可以获得以下结果:
-
返回内容:创建成功会返回新码表的ID;查询会返回码表的名称、编码、描述与完整码值清单。
-
完成状态:命令返回成功表示请求已被受理。
-
查看与验证:您可以在Dataphin控制台「标准-标准代码(码表)」页查看码表及其码值,确认与预期一致。
命令行返回成功仅表示请求已受理,最终请以Dataphin界面显示的实际结果为准。
附录:输入信息
以下为管理数据标准码表时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。
|
信息项 |
是否必填 |
说明 |
示例 |
|
租户ID |
是 |
目标Dataphin租户的ID,为19位数字。 |
1234567890123456789 |
|
码表名称 |
条件必填 |
码表的名称,在归属目录内唯一;创建与更新时需提供。 |
订单状态码表 |
|
码表编码 |
条件必填 |
码表的编码,在租户内唯一,建议采用大写下划线风格;创建与更新时需提供。 |
ORDER_STATUS |
|
码表ID |
条件必填 |
目标码表的ID;查询、更新、删除时需提供,可从控制台获取或从创建返回结果中记录。 |
—— |
|
码值清单 |
否 |
码表的代码值列表。每个码值含代码值与代码名称(均必填、不超过64字符、代码值在码表内唯一),可选英文名与描述。 |
待支付、已支付、已退款 |
|
归属目录 |
否 |
码表挂载的目录路径。 |
/标准/码表 |
|
描述 |
否 |
码表的补充说明。 |
订单状态枚举字典 |
|
负责人 |
否 |
码表负责人,不指定时默认为当前用户。 |
—— |