您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,批量查询资产的自定义属性值,并查询单个资产的目录挂载层级链与专题、目录描述。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。
功能介绍
资产详情综合查询能力支持您通过自然语言指令,只读地拼出一个资产的完整画像,覆盖两类信息:一是按一批资产GUID批量读取自定义属性的当前取值,可选只取关心的属性;二是查询单个资产挂载的专题与目录,并返回从根到叶子的完整目录层级链。该能力常用于资产盘点、画像展示以及属性写入后的回读校验,全部为只读查询,不会对资产做任何修改。
适用场景:
-
一次性获取一批资产的自定义属性当前取值。
-
查询某资产挂在哪个专题或目录下,以及从根到叶子的完整目录层级路径。
-
属性写入后回读校验,确认属性值已按预期生效。
能力限制:批量查询属性值时单次资产GUID上限为50,超限需分片查询;查询不存在的GUID不会报错,只是结果中不含该资产,需核对结果判断GUID有效性;本能力为纯只读查询,属性值的写入需使用资产自定义属性管理能力。
使用前提
-
当前账号具备资产查询相关的权限。
-
已获取要查询的资产GUID。若只知道表名或字段名,可先将其解析为GUID。
使用示例
您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:
-
查一下这批表资产的自定义属性值。
-
这个资产挂在哪个专题和目录下,把完整的目录层级路径给我。
-
只查这批资产的治理状态和上架描述两个属性。
交互步骤:
-
您发出查询指令后,Agent会与您确认要查询的资产GUID及关心的属性范围。
-
若资产数量较多,Agent通常会按每批不超过50个GUID分片查询。
-
Agent执行查询后,会整理并返回资产的属性值或目录层级信息。
-
若某个GUID未在结果中返回,Agent通常会提示该资产可能不存在,需您核对。
执行结果
操作完成后,您可以获得以下结果:
-
返回内容:属性查询返回每个资产的自定义属性编码与取值;目录查询返回资产挂载的专题、目录及从根到叶子的完整层级链。
-
完成状态:命令返回成功即完成查询;不存在的GUID不会报错,但也不会出现在结果中。
-
查看与验证:您可以核对返回结果中是否包含目标资产GUID及其属性值或目录信息。
本能力为只读查询,不会对资产做任何修改;查询结果以命令返回的实际数据为准。
附录:输入信息
以下为综合查询资产详情时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。
|
信息项 |
是否必填 |
说明 |
示例 |
|
租户ID |
是 |
目标Dataphin租户的ID,为19位数字。 |
1234567890123456789 |
|
资产GUID列表 |
条件必填 |
查询属性值时提供的资产GUID数组,单次上限50。 |
odps.租户.项目.表名 |
|
属性编码列表 |
否 |
只查询关心的属性编码;不填时返回该资产的全部自定义属性。 |
治理状态、上架描述 |
|
资产GUID |
条件必填 |
查询目录层级时提供的单个资产GUID。 |
odps.租户.项目.表名 |
|
是否含字段信息 |
否 |
查询目录时是否一并返回字段级信息,默认为否。 |
否 |
|
是否含明细属性 |
否 |
查询目录时是否一并返回明细属性,默认为否。 |
否 |