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