资产盘点与元数据补全让您通过自然语言描述触发对 Catalog / Schema 的自动化治理检查，Buddy 自动扫描元数据缺口、生成补全建议，并支持自然语言语义找数，在关键节点等待您确认后落地。
概述
资产盘点是数据治理的起点，帮助您快速了解数据资产的元数据质量和使用状态。本功能覆盖以下场景：
元数据完整性扫描：识别缺失表描述、缺失字段描述、缺失 Owner 的资产，并按治理缺口严重度排序。
元数据自动补全：基于字段名称与上下文语义，AI 自动生成表描述与字段描述建议。用户可在弹窗中查看批量写入结果，一键确认后保存。
自然语言找数：用户用自然语言描述数据需求，AI 基于 Catalog 元数据（表名、字段名、表描述、标签等）进行语义匹配，返回最相关的表列表。找数结果附带「使用频率」与「最近活跃度」信息，数据来源为查询日志与 Catalog 统计。
Buddy 自动扫描目标范围内的资产，生成盘点报告，并在关键操作节点等待您确认后落地。单次盘点扫描无表数量上限限制，Schema 下表数量较大时系统将自动处理。
前提条件
工作空间已开通 Buddy。
当前账号拥有 Buddy 开发模式权限。
对需要盘点的 Catalog / Schema 拥有查看权限。
如需执行元数据写入（补全描述、设置 Owner），需要对应 Catalog 的元数据编辑权限。
您必须提供的信息
Buddy 在执行资产盘点前会要求您提供以下最小信息集，其余由 AI 自动分析：
信息项 | 说明 |
盘点范围 | 目标 Catalog、Schema 或具体表名 |
盘点目的 | 检查元数据完整性 / 补全描述 / 找数（可通过自然语言隐含表达） |
如果您的输入不完整，Buddy 会通过「Ask User 卡片」反问缺失信息后再继续；输入完整时会直接执行并展示结果。
AI 可智能生成的内容
内容项 | AI 生成方式 |
元数据缺口报告 | 扫描所有表与字段的描述、Owner、标签，按缺失严重度排序 |
表描述建议 | 基于表名、字段名推断业务含义，生成中英文描述 |
字段描述建议 | 分析字段名称模式（如 create_time、user_id）与数据类型，生成语义描述 |
Owner 推荐 | 基于表的创建者、最近修改者、使用频率推荐 Owner 人选 |
语义找数结果 | 基于自然语言描述在 Catalog 元数据中做语义匹配，结合使用频率与活跃度排序 |
操作步骤
步骤 1：表达盘点需求
在 Buddy 输入框用自然语言描述需求，Buddy 会自动识别盘点类型与目标范围。
示例输入：
帮我看看 ods_catalog.dw_order 这个 Schema 下哪些表缺少描述
给 dwd_order_detail 表的所有字段自动补全描述
有没有记录用户浏览商品行为的表？最好是最近有人在用的
帮我找一下存储订单退款信息的表
这个 Schema 下有哪些表没有 Owner？
步骤 2：补充缺失信息
如果输入不完整，Buddy 会通过 Ask User 卡片反问您：
未指定 Catalog / Schema 时，Buddy 会列出当前 Workspace 下可用的 Catalog 供选择。
补全范围不明确时（单表、全 Schema），会要求您确认。
回答后 Buddy 继续执行。
步骤 3：审阅 AI 生成的结果
根据不同场景，Buddy 会展示不同形式的结果：
元数据盘点场景：以表格展示扫描结果，包含：
表名、缺失项类型（表描述、字段描述 / Owner）、缺失数量、严重度评级
总体缺失率统计与排序
元数据补全场景：以弹窗展示 AI 生成的描述建议，包含：
表、字段原始名称
AI 建议的描述文本
置信度标识
自然语言找数场景：以列表展示匹配结果，包含：
表名与所属 Catalog / Schema 路径
表描述与核心字段概要
语义匹配度评分
最近使用频率与活跃度信息（数据来源为查询日志与 Catalog 统计）
说明：
您可以在补全建议中修改 AI 生成的描述后再确认写入。
步骤 4：确认并落地
元数据补全：在弹窗中查看批量写入结果，一键确认后 Buddy 调用 DataBuddy 接口批量写入描述，并展示写入结果（成功条数、失败条数）。
Owner 设置：确认 Owner 人选后，Buddy 批量更新表的 Owner 信息。
找数结果：您可以直接对找到的表继续操作，例如「帮我给这张表配质量规则」「查看这张表的字段详情」。
关键节点确认
确认项 | 确认时机 | 说明 |
盘点范围 | 扫描前 | 确认要扫描的 Catalog / Schema / 表 |
补全内容 | 写入前 | AI 生成的描述建议，可逐条修改 |
Owner 人选 | 设置前 | AI 推荐的 Owner，可替换 |
批量操作 | 批量写入前 | 弹窗展示批量补全结果，一键确认后写入 |
常见问题
Q：元数据补全会覆盖已有的描述吗？
A：不会。Buddy 默认只补全缺失的描述字段，已有描述不会被覆盖。如果您需要重新生成已有描述，可以明确指示「重新生成 xx 表的描述」。
Q：自然语言找数的匹配范围是什么？
A：Buddy 会在当前 Workspace 下您有权限访问的所有 Catalog 中进行语义搜索。搜索基于 Catalog 元数据（表名、字段名、表描述、标签等）进行语义匹配，并结合使用频率与活跃度（来源为查询日志与 Catalog 统计）进行综合排序。
Q：AI 生成的字段描述准确率如何？
A：AI 主要基于字段名称模式（如
create_time → 「创建时间」）和上下文语义推断，对规范命名的字段准确率较高。对于业务特定缩写或自定义命名，建议您审阅后按需修改。Q：批量补全时如何确认？
A：Buddy 会在弹窗中展示所有待写入的描述建议，您可以逐条查看和修改，然后一键确认批量写入。
相关文档
数据目录概述
