注意:特征管理页面为纯索引视图 ,不提供创建特征表或批量导入按钮。特征表的创建通过 特征工程 SDK 的 create_table 完成,或通过下文自动识别方式将已有表纳入管理。
一、前提条件
·已开通 DataBuddy 服务并完成空间初始化。
·当前账号在目标 Catalog / Schema 上拥有相应的查看或元数据维护权限。
二、特征管理列表检索与筛选
在左侧导航栏选择 数据科学 > 特征管理 ,进入特征管理列表页。列表以纯索引视图展示当前 Workspace 中所有已识别的特征表。
顶部操作区
·搜索特征表 :按特征表名称模糊检索。
·范围筛选 :按特征表责任人 、所属 Catalog (支持多选)、标签 进行筛选。
·刷新 :重新加载列表,获取最新状态。
·Buddy :打开 Buddy 入口,与智能体实时互动。
特征表列表区
| 字段 | 说明 |
| 特征表名称 | catalog.schema.table 格式,点击跳转至特征表详情页 |
| 责任人 | 该表在 Catalog 中登记的责任人 |
| 在线表 | 关联的在线特征表所在的 Catalog 名称(鼠标悬停可查看全名);未发布在线表时为空 |
| 最近更新时间 | 表数据或元数据的最近一次更新时间 |
| 标签 | Catalog 中维护的标签集合 |
| 描述信息 | Catalog 中维护的表描述 |
三、查看特征表详情
特征表本质是 “用特征工程 SDK 声明了主键和时间戳键的 Catalog 中的表” ,因此其详情页即该表在数据目录中的资产详情页。可通过以下任一方式进入:
·从特征管理列表进入 :在特征管理列表中点击特征表名称。
·从数据目录进入 :在左侧导航栏选择 目录 (Catalog),展开目标 Catalog > Schema > 表,点击对应的特征表。
四、顶部操作栏
页面顶部展示当前特征表的名称、路径(快速访问 / <catalog> / <database> / <table>)以及一组操作入口:
| 操作 | 说明 |
| 搜索字段名称 | 在当前表的字段列表中按字段名快速过滤 |
| 根据表创建 | 下拉菜单,基于当前特征表快速发起下游操作(详见下表) |
| 修改名称 | 修改特征表名称 |
| 删除表 | 删除当前特征表(等价于 SDK 的 drop_table,操作不可恢复) |
| Buddy | 一键带着当前表上下文进入 Buddy 进行智能分析 |
根据表创建 下拉项:
| 入口 | 说明 |
| 在线表 | 将当前离线特征表发布为在线特征表(详见特征工程 SDK) |
| NoteBook | 新建 Notebook 并自动带入当前表,便于直接读写特征数据 |
| SQL 探索 | 打开 SQL 探索并预填当前表,便于即席查询 |
| 仪表盘 | 基于当前表创建可视化仪表盘 |
| 分析空间 | 进入 Buddy 对当前表做对话式分析 |
| 质量任务 | 为当前表配置数据质量校验任务 |
| Power BI 连接插件 | 获取 Power BI 连接当前表的配置 |
五、标签页
详情页提供 概览、数据预览、血缘、权限、详情、变更历史、质量 等标签页:
·概览 :维护特征表元信息的主入口。可点击 添加描述 补充表的业务说明、编辑 责任人 、添加标签 维护表级标签;在字段列表中可编辑字段的 字段描述 、为字段 添加标签 (主键字段带 PK 标识、时间戳键带相应标识)、添加脱敏策略 。
·数据预览 :查看特征表数据样本。
·血缘 :查看该表的上下游血缘关系。
·权限 :查看与管理该表的访问权限。
·详情 :查看表的 Schema、字段定义、存储信息等。
·变更历史 :查看表结构与数据的变更记录。
·质量 :查看数据质量校验结果。
注意:表级描述、责任人、字段描述、字段标签等元数据均由 Catalog 统一维护,修改后会同步到特征管理列表。建议在特征表正式投入训练之前补充完整,帮助下游使用者理解每个特征的业务含义。
六、自动识别已有表为特征表
Catalog 中任意一张同时 具备主键和时间戳键的表都会被自动识别 为特征表,无需调用 SDK 或在页面上执行任何额外操作。表在创建时已由数据工程流程或特征工程 SDK 指定好主键与时间戳键,则该表会立即出现在特征管理列表中。
表详情页 概览 Tab 的字段列表中,主键字段右侧以 PK 标识展示、时间戳键字段右侧以时间戳图标展示,但这两个属性是在表创建时确定并由后端读取的元数据 ,当前 UI 不提供标记主键或标记时间戳键的可编辑入口 。要让一张已有表被识别为特征表,需要在表的源头(DML / SQL DDL / 特征工程 SDK create_table)中保证其同时具备主键与时间戳键。
注意:仅当主键与时间戳键同时 存在时,该表才会被识别为特征表。仅有主键或仅有时间戳的表不会出现在特征管理列表中。
七、验证方式
如需确认一张表是否被识别为特征表:
1. 在左侧导航栏选择 目录 (Catalog),进入对应 Catalog > Schema > Table 详情页。
2. 查看字段列表中是否有字段被标记为 PK (主键)以及是否有字段带有 时间戳 图标。
3. 同时满足两项时,进入 数据科学 > 特征管理 ,可在列表中找到该表。可点击列表页的 刷新 按钮重新加载。
八、发布在线特征表
如果模型需要部署为在线推理服务,则其依赖的离线特征表必须先被发布为在线特征表,由同步任务持续把离线数据同步到在线存储(PostgreSQL)。
1. 进入 数据目录 ,打开目标离线特征表详情页。
2. 在 根据表创建 中选择 在线表 ,弹出在线表创建窗口。
3. 在弹窗中配置参数并提交。系统会自动创建在线特征表,并同时创建一条特征同步工作流。
注意:仅 Catalog 中具有主键和时间戳的离线特征表会展示 创建在线表 入口;不满足条件的表无法发布为在线表。
弹窗参数 :
| 参数 | 说明 | 是否必填 |
| 计算资源 | 运行同步任务的计算资源 | 是 |
| 存储地址 | 用于在线表的 PostgreSQL 数据源 | 是 |
| 数据目录 / Schema / 表名 | 在线特征表的目标 Catalog、Schema 与表名 | 是 |
| 同步方式 | 快照 / 定时触发 / 持续运行 | 是 |
注意:开通数据源指引参考 开通数据源。
选择并配置同步方式 :
| 同步方式 | 适用场景 | 触发逻辑 |
| 快照 | 一次性把离线特征表的当前快照同步到在线表,常用于首次发布或临时刷新 | 提交后立即执行单次同步 |
| 定时触发 | 周期性从离线特征表更新到在线表,例如每天凌晨同步当日产出的特征 | 按调度周期或 Cron 表达式定时触发 |
| 持续运行 | 实时性要求较高时连续运行同步任务 | 任务完成一次后立即开始下一次执行 |
调度配置项的详细规则与 Workflow 调度保持一致,详见 调度与触发器。本场景下需注意以下差异:
1. 持续运行模式不支持排队模式与最大并发数配置。
2. 任务重试模式(仅持续运行模式):
·失败 :只要其他任务仍在首次尝试运行,失败的任务就会重试;如果所有任务都进入重试状态,会创建一个新的作业运行。
·从不 :失败后不再重试。
注意:特征同步工作流的 Notebook 文件由系统创建并放置在固定目录,不允许修改任务文件内容、删除工作流或调整任务结构;你仅能修改其调度配置并启动运行。
注意:除页面操作外,也可在 Notebook 中通过 SDK 的 publish_table 一键发布在线表,详见 特征工程 SDK – 在线特征表操作。
九、Q:在特征管理列表中没有看到刚创建、标记的表?
请确认目标表是否同时 具备 主键 与 时间戳键 。在 Catalog 表详情页检查字段标记;只有同时满足两项条件的表才会被识别为特征表。可点击列表页的 刷新 重新加载。
十、Q:特征表的字段描述、字段标签为什么要在 Catalog 里维护,而不是特征管理模块?
在 DataBuddy 中,特征表本质是 Catalog 中的表,所有元数据维护逻辑统一在 Catalog 完成。特征管理模块通过跳转复用同一份元信息,避免出现两套描述不一致。
十一、Q:特征表的负责人转交后,原负责人是否仍能维护标签?
标签维护权限随 Catalog 中的表权限走。负责人转交后,原负责人若未保留对应权限,将无法继续维护表元数据;此机制与 Catalog 资产管理一致。
十二、相关文档
·特征工程 SDK
·最佳实践与异常排查
·数据目录概览
·调度与触发器