结构浏览与对象树
对象树是 DBX 的主要导航入口。它不仅展示数据库、Schema、表和字段,还负责连接分组、可见范围、对象搜索、固定、复制粘贴、结构操作、专项工作台和管理视图。
连接与对象层级
典型关系型结构如下:
连接分组
└── 连接
└── Catalog / 数据库
└── Schema
└── 表 / 视图 / 例程 / 其他对象
└── 字段 / 索引 / 外键 / 触发器实际层级由数据库模型决定:
| 类型 | 树结构示例 |
|---|---|
| MySQL 兼容 | 连接 → 数据库 → 表/视图 → 字段/索引/外键/触发器 |
| PostgreSQL、Oracle、SQL Server 等 | 连接 → 数据库或服务 → Schema → 对象 |
| Doris / StarRocks | 可在多 Catalog 时显示 Catalog → 数据库 → 表;只有 internal 时保持扁平 |
| Redis | 连接 → Redis DB;Key 在专用浏览器中分页展示 |
| MongoDB | 连接 → 数据库 → 集合、索引和 GridFS Bucket |
| Elasticsearch / Easysearch / Meilisearch | 连接 → 索引等文档对象 |
| Apache CouchDB | 连接 → 以文档集合形式展示的 CouchDB 数据库 |
| HBase、向量、消息队列、etcd、ZooKeeper、Nacos | 展示系统对应对象,并打开 专项工作台 |
连接分组与批量管理
- 创建嵌套分组和自定义子组名称
- 把连接拖入分组,或使用复制/粘贴和批量移动
- 多选连接后使用工具栏执行分组、复制、断开或其他批量操作
- 为连接设置颜色、备注、置顶、只读和生产环境范围
- 复制连接名称或复制整个连接配置作为新连接
- 在连接提示中查看主机、端口、数据库类型和其他摘要
导入连接时,支持的来源可以保留分组信息。跨设备迁移侧边栏布局时,DBX 会重新映射连接 ID。
展开、折叠与固定
- 单击节点展开或折叠
- 使用展开全部或折叠全部处理当前树范围
- 固定常用连接、数据库、Schema、表或 Nacos Namespace
- 长列表滚动时,当前数据库或关键行可以保持可见
- 打开的标签页会反向选中或定位对应对象
固定用于提高访问效率,不代表生产保护。生产连接应单独启用 生产环境与写入安全 中的只读和生产标记。
搜索与过滤
对象树搜索可以匹配:
- 连接、分组、数据库、Catalog 和 Schema
- 表、视图、字段、索引和部分数据库专属对象
- 对象路径、字段注释和表注释
- 已加载元数据和支持服务端过滤的表列表
部分搜索会把关键词传给驱动并延迟请求,避免先加载全部表。也可以按节点类型缩小搜索范围,或在当前数据库中使用本地表搜索。
可见范围设置可以隐藏不需要的数据库、Schema、系统 Schema 或带特定前缀的表。新增数据库或 Schema 后,可以按设置自动加入可见列表。
元数据显示
根据数据库和设置,对象树可以显示:
- 表和字段注释
- 字段类型、可空、默认值和约束摘要
- 对象数量或加载状态
- 表类型、Catalog、Schema 和数据库路径
- MongoDB Collection 元数据
- 数据库专属对象类型和状态
对象元数据显示方式可以在设置中调整。大型 Schema 建议只展示真正需要的附加信息,减少视觉噪声和元数据请求。
打开数据、结构与源码
编辑存储过程或函数时,可以使用保存按钮旁的眼睛图标预览更新 SQL。对象浏览器源码面板和独立源码弹窗均提供此入口,显示当前草稿由该数据库保存生成器生成的全部语句(例如 MySQL 的 DROP 和 CREATE)。预览支持复制,但不会保存草稿或执行数据库写入;修改草稿、切换对象或连接后需要重新预览。实际保存仍经过原有只读、生产确认和对象版本检查。
| 操作 | 结果 |
|---|---|
| 打开表 | 进入 数据表格 |
| 查看结构 | 打开字段、索引、外键、触发器和 DDL 标签 |
| 编辑表结构 | 进入 表结构编辑器 |
| 查看 DDL | 读取数据库生成或驱动生成的对象定义 |
| 打开源码 | 在侧边面板或编辑器查看视图、过程、函数、触发器等源码 |
| 定位查询对象 | 从编辑器光标定位当前表,或从对象树拖字段/表引用到 SQL 编辑器 |
| 打开专项对象 | 进入 Redis、MongoDB、向量、HBase、MQ、etcd、ZooKeeper 或 Nacos 工作台 |
表、对象和数据标签使用不同身份,避免同名对象与表数据标签错误复用。
从 Schema 或所属对象打开触发器
Oracle、OceanBase Oracle 和 DM8 在驱动提供精确触发器元数据时,可以从 Schema 的「触发器」组浏览,也可以从实际所属表或视图的触发器节点打开。同名但 owner 不同的触发器是不同对象;触发器 owner、所属对象 owner 和执行 Schema 分别显示,不根据树标签推断。
- 从触发器菜单打开源码;弹窗或源码标签沿用当前打开方式设置。
- 从 Schema、空触发器组或所属表/视图的菜单新建,先选名称和支持的作用域,再生成、修改并预览完整定义。非表级触发器按实际作用域显示,不绑定虚构的父表。
- 菜单按实际驱动能力提供启用、禁用、编译和删除。批量删除沿用同类节点多选规则,先核对全部 SQL,再按序执行;无法核实某一步时停止后续步骤。
结果未知时,保留原行并使用错误详情中的「只读核实」检查数据库,不要直接重发删除。状态含义和源码恢复步骤见 对象浏览器。
右键菜单与批量操作
上下文菜单按节点类型和数据库 capability 动态生成。常见操作包括:
- 创建、重命名、删除数据库或 Schema,并编辑支持的注释、字符集和排序规则
- 创建、复制、粘贴、重命名、清空或删除表
- 跨数据库复制/粘贴表数据或表结构(目标驱动支持时)
- 打开数据、结构、DDL、源码、ER 图、字段血缘、Schema 对比和数据库搜索
- 导入数据、传输数据、执行 SQL 文件、导出数据库或备份支持的文件型数据库
- 生成
SELECT、INSERT、UPDATE、DELETE或其他模板 SQL - 管理索引、触发器、例程、扩展、用户、任务和数据库专属对象
- 打开 Dashboard、进程/会话或专项管理页面
破坏性操作会整理到更明确的菜单层级,并按只读、生产环境和数据库能力决定是否显示或要求确认。
复制、粘贴与拖拽
- 复制连接、数据库、Schema、表、字段或所选表名
- 选择是否带数据库/Schema 限定和标识符引号
- 把表或字段拖入 SQL 编辑器生成引用
- 复制表后在兼容目标数据库中粘贴,实现表结构或数据传输入口
- 本地文件数据库可以从对象树在系统文件管理器中显示文件
跨数据库复制涉及类型映射、默认值、约束和自增语义。执行前查看 数据传输 和生成 SQL。
数据库专属层级
DBX 不会把所有系统强制映射成关系型树。例如:
- SQL Server 可以浏览 Linked Server 和数据库对象
- Doris / StarRocks 支持外部 Catalog,外部 Catalog 表使用三段式名称
- MongoDB 展示 Collection、索引和 GridFS
- Elasticsearch / Easysearch / Meilisearch 将索引作为一等对象
- Apache CouchDB 将每个数据库作为文档集合展示
- 达梦、Oracle、PostgreSQL 等可以展示更多例程、任务、扩展或管理对象
- etcd、Nacos、消息队列和向量数据库从树节点进入专用工作台
安全与性能边界
- 对象树只展示当前账号有权限读取的对象;看不到对象时先检查数据库权限
- 大型 Schema 使用按需加载、缓存和服务端过滤,不建议无目的展开全部节点
- 系统 Schema、对象数量和额外元数据会增加请求量,可以在设置中关闭
- 删除、清空、跨库粘贴和管理操作可能不可恢复,生产环境先确认备份和影响范围
- 只读连接会隐藏或拒绝多个修改入口,但数据库账号权限仍是最终边界