读取数据库表视图树

POST /meta/db/tree。由单个非空X-Workspace-ID选择工作区,handler不读取请求体,无分页、搜索或数据库选择业务参数。可发空体或{},不能复用数据库分页接口参数并宣称在这里生效。

请求参数

POST https://api.moi.matrixorigin.cn/v5/meta/db/tree

不读取业务请求体,无分页、搜索或数据库选择参数;工作区通过单个非空 X-Workspace-ID 指定。

成功响应

成功为数字code=200、data.db_list。service在当前调用者会话列数据库,再逐库SHOW FULL TABLES分出表/视图;不是原子数据库目录快照,任一库读取失败可使整个请求失败。

字段

类型

当前映射

data.db_list

array 或 null

无数据库时可能为null,非分页结果

db_list[].db_name

string

数据库名称

db_list[].display_name

string

DTO可选,但当前tree转换未设置,不应据此判断Catalog显示名能力缺失

db_list[].is_internal

boolean

当前元数据内部标记

db_list[].is_subscription

boolean

当前转换未赋值,输出false,不足以判断真实订阅状态

db_list[].has_published

boolean

同样为当前映射零值,不能作发布状态探针

db_list[].tables / views

object

每组都有tables与total,views组内列表也名为tables

groups.tables

array 或 null

以下表/视图条目

groups.total

integer

该组返回数量

entries.name

string

SHOW FULL TABLES所得名称

entries.owner / created

string

当前转换为空字符串

entries.rows / size

integer

当前树转换无统计采集,零值不表示实际空表或零字节

字段路径中groups/entries只是表内简写,实际路径例如data.db_list[].views.tables[].name。SDK模型中的db_owner也不等于此handler一定返回该字段。错误使用SQL数值code/message封套,身份/通用错误可能为字符串code/msg;

最后更新于