# 读取数据库表视图树

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

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

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

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

:::::
:::::{tab-item} 参数说明

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

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 字段说明

成功为数字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；

:::::
::::::
:::::::
