二、前提条件
·已开通 DataBuddy 服务并完成空间初始化。
·当前账号在目标工作空间中拥有创建 Catalog 的权限（默认主账号、控制台管理员可创建；其他用户需被授予 create catalog 权限）。
·已了解 三级命名空间 的基本概念。
三、使用限制
| 限制项 | 说明 |
| 支持地域 | 全部支持 DataBuddy 的地域 |
| 存储后端 | 当前仅支持腾讯云 COS；存储路径在 Catalog 创建时由系统按 default 存储空间分配 |
| 系统保留名 | information_schema / default 不可作为 Schema 名 |
| 引擎能力 | 表的实际读写依赖计算资源对该 Catalog 的引擎支持，DLC Spark / SQL 已支持 |
五、步骤 1：进入数据目录
1. 登录 DataBuddy 控制台，切换到目标工作空间。
2. 在左侧导航栏选择数据目录 。
六、步骤 2：新建 Catalog
1. 在左侧目录树顶部点击 + 创建数据目录 。
2. 在 创建数据目录 弹窗中配置参数：
·目录名称 ：必填。
·目录来源 ：必填
·目录类型 ：必填
·目录用途 ：必填
·描述 ：可选，最多 500 字符。
3. 点击 确定 完成创建。
创建成功后，你会自动进入新 Catalog 的详情页，并看到系统自动生成的 Schema： default。
注意：说明：
注意：若 + 创建数据目录 按钮置灰且 hover 提示「你暂无权限」，请联系主账号或当前区域的元数据湖 admin 为你授予 create catalog 权限。
七、管理 Schema
Schema 在 Catalog 下提供二级命名空间，用于按业务主题或项目划分对象。
八、创建 Schema
1. 在 Catalog 详情页点击创建 Schema 。
2. 在弹窗中输入：
·Schema 名称 ：必填，在当前 Catalog 内唯一。
·描述 ：可选。
3. 点击确定 完成创建。
创建成功后，你会自动进入 Schema 详情页。
九、查看 Schema 列表
在 Catalog 详情页 概览 Tab 中：
·通过名称搜索框可对 Schema 名称做实时模糊匹配。
·列表展示 Schema 名称、描述、负责人（默认是创建人）、创建时间
十、删除 Schema
在 Schema 详情页右上角的 菜单中：
·删除 ：二次确认后删除整个 Schema 及其下属对象。
注意：仅 Schema 的 owner、Catalog owner 和具备 drop schema 权限的用户可执行删除操作；其他用户对应入口置灰。
注意：警告：
注意：删除 Schema 不可恢复，且会同时删除其下所有表、视图等对象。请在删除前确认无依赖任务。
十一、管理表与视图
DataBuddy 中，表与视图均归属于 Table 类 Catalog 的 Schema。
十二、创建表
DataBuddy 通过数据接入模块创建表：在 Catalog 详情或 Schema 详情页点击 添加对象 > Table ，跳转到数据接入的建表流程。建表完成后，新表会自动出现在所在 Schema 下。
详细建表方式请参考：
·离线数据同步：表到表同步
·实时整库多表任务
十三、表详情
在 Schema 详情页或左侧目录树中点击表名，进入表详情页。表与视图共用同一个详情页结构，主要内容包括：
| Tab | 内容 |
| 概览 | 表描述（可编辑）、字段列表（字段名称、字段类型、字段描述、字段标签） |
| 数据预览 | 表数据采样，默认通过 DLC 引擎拉取，加载数据预览需要使用计算资源 |
| 血缘 | 上下游血缘关系，详见 数据血缘 |
| 权限 | 当前表的授权情况，详见下方 权限管理 |
| 详情 | 表的技术信息，eg：数据类型、表类型、存储路径、存储量、创建时间、创建人、数据变更时间、变更人等 |
| 变更历史 | 表的变更时间、变更类型，变更的用户，变更的操作等信息。加载变更历史需要使用计算资源 |
| 质量 | 关联的数据质量规则，详见 数据质量 |
十四、表的右侧信息面板
表详情页右侧固定展示：
| 模块 | 字段 |
| 业务信息 | 标签（治理标签，可编辑）、负责人（支持转交） |
| 技术信息 | 数据类型（内部表 / 外部表）、数据源、存储路径（可复制）、存储量、创建时间、数据变更时间、创建人、变更人 |
| 功能信息 | 数据预览、血缘、权限、详情、变更历史、质量 |
十五、编辑字段元数据
在表详情页 概览 Tab 的字段列表中：
·点击字段描述 旁的笔形图标可编辑字段描述。
·点击标签 旁的笔形图标可为字段添加治理标签（key:value 形式）。
十六、视图
视图与表共用同一个详情页结构。
注意：说明：
注意：当前版本不支持通过 UI 创建视图（View）。如需创建视图，请使用计算引擎的 SQL 语法（如 DLC Spark SQL 的 CREATE VIEW）。
十七、重命名、删除表
表详情右上方支持
·修改表名称 ：弹窗中修改表名后保存。
·删除表 ：二次确认后删除整张表。
仅表的 owner、所在 Schema 的 owner 和具备 drop 权限的用户可执行；其他用户对应入口置灰。
十八、收藏与最近访问
在 Catalog 详情页右侧详情区，你可以通过以下方式快速回到常用资产：
·全部目录 ：列出当前工作空间可见的全部 Catalog。
·最近访问 ：按上次查看时间倒序展示你近期浏览过的 Catalog / Schema / 表、视图，可按资产类型筛选。
·我的收藏 ：展示你手动收藏的资产。表、视图 / Schema / Catalog 详情页右上角的星形图标可加入收藏。
十九、在表详情页快速创建分析任务
在表详情页右上角的 创建 下拉菜单中，可一键创建关联当前表的开发任务：
| 入口 | 跳转目标 |
| Notebook | 跳转到 Notebook IDE，自动带入当前 Catalog / Schema 上下文 |
| SQL 探索 | 跳转到 SQL 探索，预填三段式表名 |
| 仪表盘 | 跳转到 仪表盘 创建页 |
| Buddy | 跳转到 Buddy 智能 分析空间 |
| 质量任务 | 跳转到 质量任务调度与执行，关联当前表创建质量规则 |
| Power BI 连接插件 | 通过 Power BI 连接插件直接消费当前表数据（需先安装插件） |
| 在线表 | 将当前离线特征表发布为在线特征表（详见 特征工程 SDK） |
20、权限管理
Catalog / Schema / 表的权限模型由三层级联控制，常用权限语义如下：
21、预设权限类型
| 预设权限 | 包含的权限点 |
| 读取权限 | use catalog + use schema + read + select + execute |
| 编辑权限 | 除 execute 与 grant 外的所有权限点 |
22、在不同层级授权
| 层级 | 可授予的权限点（节选） |
| Catalog | use catalog、create catalog、alter catalog、drop catalog，以及 Schema 与对象层级的所有权限点（向下覆盖） |
| Schema | create schema、use schema、alter、drop、select、insert、create table、create model、create volumes 等 |
| Table / View | alter、drop、select、insert、all、grant |
注意：说明：
注意：权限点之间存在依赖关系。例如授予表的 select 权限，需同时授予该表所在 Catalog 的 use catalog 与 Schema 的 use schema，否则用户无法定位到该表。授权弹窗会在确认前提示你勾选依赖项。
23、仅 owner 与具 grant 权限的用户可授权
·主账号、Catalog / Schema / 表的 owner 默认拥有 grant 权限，可对其管辖的层级授权。
·普通用户在未被授予 grant 的情况下，授权按钮置灰 ，hover 提示「你无法授予权限，请联系主账号或 owner 获取权限」。
24、没有权限时的可见性
·没有权限的 Catalog / Schema / 表会在目录树中置灰展示 （而非隐藏），便于用户感知数据存在并申请权限。
·用户可勾选 只展示有查询权限的数据 进行筛选。
·进入无权限对象的详情页时，仅可查看 概览 Tab 的元数据；其他 Tab 置灰，hover 提示「你只能查看该资源对象的元数据，请联系主账号或 owner 获取权限」。
更多权限规则请参考 成员与权限管理。
26、添加、修改治理标签
Catalog / Schema / 表的右侧信息区均可添加治理标签：
1. 在 业务信息 > 标签 旁点击笔形图标。
2. 在弹窗中选择已有标签 key 与 value，可同时添加多个。
治理标签的整体管理请参考 治理标签。
27、owner 转交
每个 Catalog / Schema / 表、视图都有 owner，初始为创建人。owner 拥有该对象的全部权限，仅 owner 可发起转交：
1. 在右侧信息区 业务信息 > owner 旁点击笔形图标。
2. 选择新的 owner（仅当前对象的 owner 可见此入口）。
3. 在弹窗中确认提示文案：「转交后你不再拥有该 catalog / schema / table 的管理权限」。
4. 点击 确定 完成转交。
28、常见问题
Q：为什么 Catalog 详情页 / Schema 详情页中的某个表显示置灰？
A：表所在 Catalog 或 Schema 你没有 use catalog 或 use schema 权限，或者你没有该表本身的访问权限。详情页 hover 会显示具体提示，请联系 owner 或主账号申请。
Q：删除 Catalog / Schema 后能恢复吗？
A：不能。删除操作不可恢复，会连带删除所有下属对象。请确认无依赖任务后再操作。
Q：可以为表添加哪些字段级元数据？
A：当前支持字段描述与字段标签（key:value 形式的治理标签）。字段级权限策略由 列级权限控制 提供。
Q：表详情页的「数据变更时间」与「创建时间」有什么区别？
A：「创建时间」是对象的初次创建时间；「数据变更时间」是元数据最近一次变更的时间（如修改字段、修改描述、表数据写入等）。
29、相关文档
·统一元数据管理架构
·三级命名空间
·非结构化数据 Catalog
·数据血缘
·成员与权限管理