目录
目录 页面用于浏览仓库中的数据并查看 SQL 对象。你可以搜索和刷新对象树、查看定义与元数据、预览数据，以及使用页面提供的管理操作。对于没有图形操作入口的对象，可以通过 SQL 或对应的管理流程创建和修改。
前置条件
- 选择包含目标数据的仓库。页面展示的是当前仓库中的对象。
- 当前数据库用户具有访问目标目录、数据库和对象所需的权限。只读用户不能执行修改操作；需要更换数据库用户时，使用 切换用户。
- 专有仓库（SaaS）和私有仓库（BYOC）均可浏览目录。符合条件的表所提供的 导入 操作仅适用于 SaaS 仓库。
数据库权限的说明参见权限管理。
浏览目录
- 登录 SelectDB Cloud 控制台。
- 选择目标仓库。
- 单击左侧导航栏的 目录。
页面包含目录列表和数据对象树。使用搜索框查找目录、数据库或对象；需要最新元数据时，刷新列表。
对象层级
目录按以下层级组织 SQL 对象：
目录（Catalog）
└── 数据库（Database）
├── 表（Table）
├── 物化视图（Materialized View）
├── 视图（View）
└── 函数（Function）
目录是数据库的集合。SelectDB Cloud 提供两类目录：
- 内部目录（
internal）：包含当前仓库自身管理的数据库、表和其他对象。 - 外部目录（External Catalog）：注册外部数据源，使你无需先将数据导入仓库即可浏览和查询。外部目录的数据库对象页提供表列表。
查看目录详情和数据库
目录列表展示名称、类型及可用操作。单击目录名称，进入详情页：
- 详情：查看目录定义和基础元数据，例如可获取的时间信息。
- 数据库：浏览目录中的数据库，按名称搜索，并查看数据库名称、数据大小等信息。
具有相应权限时，可以对符合条件的内部非系统数据库执行额外管理操作。外部目录中的数据库和系统数据库不提供这些操作。目录本身的删除操作仅适用于有权限删除的外部目录。
删除外部目录会移除仓库中注册的数据源连接。删除前，确认查询和业务任务不再依赖该目录，并阅读确认提示。
查看数据库对象
选择数据库后，可以切换到当前目录支持的对象页签。内部目录可以展示 表、物化视图、视图 和 函数；外部目录仅展示 表。
| 对象 | 可以查看的内容 |
|---|---|
| 表 | 列表包含名称、数据大小、创建时间、最后修改时间和注释。单击表名称，可以查看 详情、字段信息、索引 和 数据概览。详情包括建表语句，以及可获取的数据模型、大小、行数、分区方式、副本数等元数据。字段信息包括类型、Key 属性、是否可空、是否可见、额外属性和注释；索引页包括名称、列、类型和注释。 |
| 物化视图 | 列表包括状态、刷新状态、数据大小、时间和注释。进入对象后，可以查看 详情、字段信息、刷新历史 和 数据概览。刷新历史用于排查刷新执行情况，包括状态、触发方式、刷新模式、进度、耗时和可获取的计算资源信息。 |
| 视图 | 浏览数据库中定义的视图，单击名称查看定义、字段和数据概览。 |
| 函数 | 浏览数据库中定义的函数，单击名称查看类型、返回类型和创建语句等信息。 |
数据概览 最多展示 100 条数据。未指定排序时，预览不保证固定顺序；需要完整查询、过滤或排序时，使用 SQL 编辑器。对象大小和行数等元数据可能存在更新延迟。
在 SaaS 仓库中，符合条件的表可以从表列表的 导入 操作启动导入流程。外部目录中的表、不支持的数据库、只读用户和 BYOC 仓库不提供该操作。数据源和导入方式说明参见导入。
添加外部目录
部署环境与权限支持时，可以通过控制台添加外部目录：
- 在目录列表中单击 添加外部目录。
- 选择页面提供的数据源类型。
- 填写目录名称、连接设置、认证信息和所需属性。不同数据源的配置要求不同。
- 核对配置后提交。创建成功后，返回目录列表，检查能否浏览对应数据库和表，并通过 SQL 编辑器验证查询。
添加外部目录 对只读用户不可用，是否显示还取决于部署环境的能力。数据湖元数据服务、关系型数据库和样例数据的接入方式不同，应按实际页面和数据源要求配置，不能将其他环境的选项视为当前仓库均可用。
控制台未提供对应入口时，可以在 SQL 编辑器中使用 CREATE CATALOG。支持的目录类型及配置参见Catalog 概述。访问私网数据源前，还需要配置网络连接。
常见问题
看不到目录、数据库或对象
先核对仓库、目录和数据库选择，然后确认当前数据库用户对目标对象具有所需的数据权限。授予父级对象的权限可以覆盖其下属对象，具体授权范围参见权限管理。对象刚创建或修改时，先刷新元数据。
无法添加外部目录
该操作受部署能力和只读状态限制。请仓库管理员确认当前环境是否支持创建外部目录，以及你的用户是否具有相应权限。
缺少预期的管理操作
操作入口取决于对象类型、目录类型、是否为系统数据库、部署方式及用户权限。例如，外部目录不提供内部数据库的管理操作，表的 导入 仅适用于 SaaS 仓库。控制台没有所需操作时，可以使用 SQL，或联系仓库管理员。
