概述
全局数据搜索 是数据发现模块的核心入口,支持以自然语言 或关键字 在工作空间范围内一键定位所需资产。AI 语义检索与关键字检索并行执行,结果合并去重后按综合相关度排序,帮助您在不知道精确名称的情况下也能找到合适的表、Notebook、工作流、仪表盘、指标、智能体等。
前提条件
已开通 DataBuddy 服务并完成空间初始化。
当前账号已加入目标 Workspace(角色权限说明详见 成员与权限管理)。
搜索结果按 ACL 权限过滤,仅展示当前账号有权查看的资产。
使用限制
限制项 | 说明 |
搜索范围 | 仅限当前 Workspace 内的资产,不跨工作空间检索 |
检索粒度 | 表名、视图名、列名、对象描述、注释,以及指标 / 语义模型 / 智能体的名称与描述等 |
对话轮次 | AI 语义回答当前仅支持单轮对话,不保留多轮上下文 |
默认结果数 | 搜索结果默认展示前 20 条,向下滚动加载更多 |
操作步骤
步骤 1:发起搜索
DataBuddy 提供两种发起搜索的方式:
顶部全局搜索框 :在控制台任意页面顶部搜索框,输入搜索内容后回车,自动跳转到全屏数据发现页。
左侧导航 数据发现 :点击数据发现 ,进入全屏页面后,在顶部搜索框输入内容。
搜索内容支持两种形式:
形式 | 示例 | 适用场景 |
关键字 | user_info、olist_orders | 已知精确表名、列名或对象名 |
自然语言 | 用户订单相关的表、最近 30 天活跃的工作流 | 不确定精确名称、希望按业务意图检索 |
后端会先判断输入是否能精准命中现有对象:能命中则直接返回精确结果,否则回退到 AI 语义检索。两路检索可能并行进行,结果合并展示。
步骤 2:阅读 AI 语义回答
当输入更接近自然语言提问时,结果区顶部会先出现 AI 语义回答:
1. AI 回答以逐字流式输出 的方式呈现,期间显示加载动画。
2. 回答内容达到默认折叠长度时会显示 展开 按钮,点击查看完整回答。
3. AI 回答下方会列出与问题相关的资产卡片,点击卡片可跳转到对应详情页。
提示
AI 语义回答仅在自然语言搜索时出现;输入精确关键字(如完整表名)时通常会跳过 AI 回答,直接展示精确匹配结果。
步骤 3:阅读搜索结果列表
每条搜索结果以卡片形式展示,包含的字段如下:
字段 | 说明 |
资产名称 | 点击跳转到对应资产详情页 |
资产类型 ICON | 标识该资产是表 / 视图 / 工作流 / 仪表盘等 |
收藏标识 | 如该资产已被当前用户收藏,显示黄色星标 |
热度 | 暂以浏览次数表示,长期将切换为被查询次数 |
Owner | 资产负责人 |
最近更新 | 资产最近一次更新时间,精度到天 |
最近浏览 | 当前用户最近 30 天内最后一次浏览的相对时间,例如「最近浏览 2 天前」;从未浏览过则不展示 |
结果默认按综合相关度排序:
排序因子 | 权重 | 说明 |
语义相关度 | 50% | AI 向量检索的余弦相似度 |
关键字匹配度 | 30% | 表名 / 列名 / 注释的精确与模糊匹配得分 |
使用热度 | 20% | 近 30 天的查询 / 访问次数 |
页面默认展示前 20 条结果,向下滚动可加载更多。
步骤 4:跳转到资产详情页
点击任意结果卡片,将进入对应资产的详情页,从详情页可以继续:
查看资产的 Schema、Owner、说明、血缘、质量监控等元信息。
查看预览数据(适用于表、视图、文件等)。
申请或管理权限。
收藏、取消收藏,以便后续在 快速开始 - 收藏 中快速返回。
不同资产的详情页字段略有差异,详情请参见各资产模块文档。
在「快速开始」中复用搜索
数据发现的搜索结果会与首页的「快速开始」联动:
快速开始 - 最近 :展示当前用户最近访问过的指标、语义模型、智能体、表等资产,便于继续上次的工作。
快速开始 - 收藏 :展示当前用户已收藏的指标、语义模型、表等资产,可在卡片上一键取消收藏。
点击「最近」或「收藏」中的资产卡片,同样跳转到对应详情页。
验证结果
完成一次搜索后,您可以通过以下方式确认搜索能力可用:
1. 在顶部输入业务关键词(例如
订单),结果列表中至少返回 1 条相关资产。2. 切换到自然语言提问(例如
有哪些订单相关的表),AI 语义回答区域出现流式输出的回答与相关资产卡片。3. 点击任意一条卡片,能成功跳转到对应资产详情页。
常见问题
Q:为什么搜索结果中看不到我知道存在的某张表?
A:可能原因如下:
当前账号没有该表的查看权限:搜索结果按 ACL 权限过滤,无权限的对象不会展示。
当前 Workspace 不是该表所在的 Workspace:数据发现仅在当前工作空间内检索,跨工作空间需切换后再搜。
该表所属的 Catalog 还未完成元数据采集:External Catalog 的元数据需要先完成同步,详见 外部数据管理。
Q:AI 语义回答与下方资产列表的关系?
A:AI 语义回答用自然语言总结当前问题相关的资产线索;下方的资产列表则是按综合相关度排序的具体资产卡片,便于您直接点击进入。两者互补,回答提供解释、列表提供入口。
Q:搜索结果排序是否可以自定义?
A:当前版本固定按综合相关度排序,暂不支持自定义排序权重。后续将持续优化排序策略。
Q:能否多轮对话式细化检索?
排序与统计口径补充说明
排序权重固定 :综合相关度的语义 50% / 关键字 30% / 热度 20% 在所有地域、所有用户群中保持一致,不会随地域或灰度策略动态调整。
使用热度统计口径 :所有资产类型的「使用热度」统一采用 近 30 天的查询、访问次数 ,与排序因子表中的描述保持一致。
AI 搜索建议 :首批已对外开放,输入时会即时推荐相关查询词。
搜索历史 & 热门搜索 :当前版本暂未对外开放,将在后续版本中逐步上线。