读取数据库表视图树¶
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;