Studio 集成数据目录（Catalog）侧栏，让您在编写 SQL / Notebook / Python 的过程中无需切换页面，即可查看库表元数据、复制表名、插入字段名并收藏常用表。数据目录侧栏的元数据源与 数据目录 保持一致，仅在展现形态上做了针对开发场景的优化。
概述
Studio 数据目录侧栏按 数据源 → Catalog → Schema → Table → Column 的层级展示，并在表与字段名后提供「插入到编辑器」「复制」「收藏」等快捷操作。可见的库表范围以当前工作空间内您拥有的 Catalog 权限为准。
场景 | 收益 |
编写 SQL 时不确定表结构 | 侧栏直接浏览字段列表，一键插入到编辑器 |
团队协作中查找他人开发的表 | 全局检索表名、备注、字段名 |
常用表频繁访问 | 收藏后置顶展示，减少查找成本 |
前提条件
已加入工作空间，且具备 Studio 模块访问权限。
工作空间已绑定一个或多个数据源，并完成相应的 Catalog 接入。
操作步骤
步骤 1：打开数据目录侧栏
1. 在 Studio 左侧切换到 数据目录 侧栏。
2. 下方按 Catalog → Schema → Table → Column 树状展开。
步骤 2：查看元数据
hover 表名 ：弹窗展示表名、创建人、描述、表大小、最近更新时间等元数据。
hover 字段名 ：弹窗展示字段名、字段类型、是否分区列、字段描述。
单击表名 ：展开字段列表。
单击字段名 ：展开字段详细信息。
步骤 3：检索元数据
1. 单击侧栏顶部 检索 图标，顶部出现独立检索框。
2. 输入关键字，可同时匹配 Catalog 名称、Schema 名称、表名、字段名。
3. 检索结果以列表展示，单击任一结果在树状目录中定位。
4. 检索范围：当前选中的数据源下所有 Catalog。
步骤 4：插入与复制
4.1 插入表名、字段名到编辑器
在表名、字段名后单击 插入 图标，当前光标位置自动插入完整三段名
catalog.schema.table 或 column_name。4.2 复制名称
hover 表名、字段名，弹窗中单击 复制 ，将名称复制到剪贴板。
用于粘贴到 SQL 编辑器或 Notebook 单元格。
参数说明
检索范围与命中规则
项目 | 说明 |
检索字段 | Catalog 名 / Schema 名 / Table 名 / Column 名 / 表描述 / 字段描述 |
命中规则 | 包含匹配（不区分大小写） |
检索范围 | 当前所选数据源下，您有权限的库表 |
单次返回上限 | 详见控制台 |
使用限制
数据目录中可见的库表受 Catalog 权限控制；详见 数据安全。
检索仅返回您有权限的对象，无权限对象不会出现在结果中。
「插入」「快速生成 SELECT」仅在 Notebook、SQL、Python 编辑器内可用。
常见问题
Q1：在数据目录中能看到一张表，但 SQL 查询时报「table not found」？
可能是默认 Catalog / Schema 未设置，导致查询时表名解析失败。请使用三段名
catalog.schema.table 引用，或在 SQL 编辑器右上角设置默认 Catalog。检查表所在 Catalog 是否已绑定到当前工作空间。
Q2：检索结果不全？
检索仅返回有权限的对象。如果您是新加入的成员，请联系工作空间管理员授予 Catalog 访问权限。
单击侧栏 刷新 重新加载元数据索引。
Q3：刚创建的表为什么在数据目录中看不到？
元数据同步存在短延迟（通常 1 分钟内）。如长时间不可见，单击 刷新 或重新选择数据源。
相关文档
SQL IDE 基础操作
