文档中心

数据智能体

结构化知识库管理

查询结构化数据资产详情

查询结构化数据资产详情

调用本接口查询指定数据资产的来源、状态、文件大小、行数和最近错误等公开元数据。

调用方：开放平台应用、外部 Agent 或集成服务。
前置条件：调用者拥有知识库查看权限。

接口说明

接口名称：get_asset_structured_knowledge_v1_kbs__kb_id__assets__asset_id__get
接口地址：/structured_knowledge/v1/kbs/{kb_id}/assets/{asset_id}
请求方式：GET

请求参数

Path

参数名	类型	是否必传	描述
kb_id	String	是	结构化知识库 ID，由创建知识库或查询知识库列表接口返回
asset_id	String	是	结构化数据资产 ID，由创建资产或查询资产列表接口返回

响应参数

参数名	类型	是否必传	描述
code	Number	是	响应码：0=成功，非0=失败
msg	String	否	Code非0时，返回错误信息
message	String	否	错误信息
data	Object	是	数据。详情请参见 data 表。

data

参数名	类型	是否必传	描述
asset_id	String	是	结构化数据资产唯一 ID
kb_id	String	是	资产所属的结构化知识库 ID
asset_name	String	是	结构化数据资产名称
source_type	String	是	文件类型 EXCEL CSV CLICKHOUSE HIVE
status	String	是	状态 DRAFT READY_PENDING_IMPORT READY DISABLED DELETED CREATE_FAILED IMPORTING IMPORT_FAILED DELETING DELETE_FAILED
source	Object	是	源数据，详情请参见下文 source 表
folder_id	String	否	资产所属目录 ID
source_file_name	String	否	原始上传文件名；数据集来源可为空
file_size	Number	否	原始文件大小，单位字节；数据集来源可为空
row_count	Number	否	当前已写入 OpenSearch 的数据行数
last_error	String	否	最近一次处理失败原因；无失败时为空
created_by	String	否	创建人账号
create_time	Number	否	创建时间，Unix 毫秒时间戳
update_time	Number	否	最近更新时间，Unix 毫秒时间戳

source

参数名	类型	是否必传	描述
source_type	String	是	文件类型 EXCEL CSV CLICKHOUSE HIVE
file_id	String	否	Excel/CSV 上传后的文件 ID
dataset_id	String	否	ClickHouse/Hive 的 Prep 数据集 ID
dataset_name	String	否	ClickHouse/Hive 的 Prep 数据集名称
database_name	String	否	源数据库名称
table_name	String	否	源数据表名称
sheet_name	String	否	Excel 工作表名称；CSV 通常为 default

最近更新时间：2026.09.17 19:26:44

这个页面对您有帮助吗？

有用

有用

无用

无用