查询和维护表、字段元数据

“数据集”集中展示采集后形成的结构化元数据。它不仅包含关系型和非关系型数据源中的对象，也包含由数据字典、DDL、API 文件及自定义元模型生成的对象。业务人员可查看定义，数据管家可维护业务属性，技术人员可检查结构和变更。

哪些对象在数据集查询

来源	数据集中常见的对象
关系型数据库	数据源、数据库、Schema、表、字段、视图、存储过程、函数、索引及约束等
HBase、MongoDB 等非关系型来源	由对应插件识别的库、集合、字段或其他技术对象
DDM 物理／逻辑数据字典、DDL 文件	解析后形成的表、字段、实体、属性、视图、存储过程、函数等
API 元数据	API 服务、接口、请求参数、响应参数及其关系
自定义元模型	元模型定义的对象、属性及父子或关联关系

标准采集和手工导入的报表到“报表”查询；只有通过文件存储服务器采集的文件到“文件”查询。详情见配置元数据采集。

当前数据集页面提供“按技术部门”视图、全部元数据与全部数据源筛选，列表可按英文名称、中文名称、资产类型、业务系统、Schema、技术部门和创建时间阅读对象。对象列表中的操作入口用于打开详情；页底显示当前查询结果数量并支持分页。

查看数据集列表原图。截图中的对象名称和统计数量来自核验环境，仅用于说明页面字段和定位方法。

查找对象

1. 进入“元数据管理 → 数据集”，选择应用系统或数据源。
2. 在搜索框输入表、字段、视图、函数、存储过程、API 或元模型对象名称。
3. 使用类型筛选及页面提供的其他条件缩小结果。
4. 打开对象，核对来源、Schema、物理名称，避免选中不同系统中的同名对象。

如果对象较多，先选择技术部门或数据源，再使用列表搜索；最后通过业务系统、Schema 和物理名称三项交叉确认。分页数量和总条数是当前筛选结果，不代表平台全部元数据。

查看表与字段

表详情提供字段信息、采样数据及血缘关系等内容。打开字段名称进入字段详情；业务描述与技术属性应结合查看，不要用中文名代替物理字段标识。

需要补充属性时，使用对应区域的编辑入口，保存后重新查看。维护前明确哪些属性来自源系统、哪些由治理人员补充；后续采集产生变化时，应结合变更历史检查。

查看视图、存储过程和函数的 SQL 语句受角色权限控制。对象可见并不表示 SQL 正文一定可见。

查看采样数据

在表或视图详情中使用采样功能。采样读取实际数据，需具备相应权限。采样失败与没有数据是两种结果：出现数据库错误时先检查错误内容、查询权限和结构读取；“暂无数据”不能单凭字面判断为连接故障。

采样用于理解字段，不等于全量数据质量检查，也不代表数据市场已完成数据交付。

Hive 采样先读取表结构，再读取指定行数的样本。结构读取失败时，应检查“采样失败”提示及数据库报错；样本查询成功但返回空结果时，页面显示“暂无数据”。排查时分别检查结构读取权限和样本查询结果，不把两种情况都记录成“表中没有数据”。

比较变更历史

在“变更历史”选择两个历史记录进行比较，检查表属性、字段及索引差异。记录新增、删除和属性变化，再结合基础血缘判断相关上下游对象。

这里的历史记录是业务对象变更历史，与产品软件版本无关。

查看对象关系

在“知识图谱”查看对象与标签、字段、应用系统等资源的关联。建立关系时选择正确的资源和关系用途；知识关联不能直接等同于数据加工血缘。

导出与批量更新

从数据源采集技术元数据后，可使用导出和更新流程批量补充业务语义。常见维护内容包括逻辑名称或中文名、业务描述、标签、责任信息，以及字段关联的数据标准等。批量更新用于补齐 DAM 中的治理属性，不应改写数据库中的物理结构。

内容	更新前检查
逻辑名称或中文名	与业务术语一致，同名对象能通过数据源、Schema 和物理名区分
描述	说明业务含义、使用范围和必要限制，不复制没有解释作用的物理名
标签	使用已批准的标签及分类口径，不在模板中临时创造同义标签
数据标准关联	标准已发布，字段含义、类型和值域与标准一致
责任信息和其他业务属性	责任人、部门和维护边界已经确认

1. 在数据源右侧“…”选择“导出元数据”，或从元数据列表进入导出。
2. 下载全部对象，或勾选表后选择“下载选中的元数据”。超出单个 Excel 可容纳范围时，系统可能拆分文件并以压缩包提供。
3. 以导出文件为基础维护表级和字段级业务语义，保留对象唯一标识、物理名称、数据源、Schema、模板列和工作表结构。
4. 回到数据源“…”选择“更新元数据”，选择修改后的 Excel 数据字典。
5. 查看导入结果和失败明细，确认空值没有覆盖已有属性，标准编码、标签等引用能够正确解析。
6. 完成后逐项核对修改对象；先用少量记录验证，再按同一模板批量更新。

导出结果反映当前筛选和权限范围，不能将局部导出当作整个环境的备份。再次采集可能更新技术属性；业务语义是否保留或发生冲突，应结合产品配置、变更历史和导入结果复核。

检查与排查

现象	检查内容
搜不到对象	系统/数据源选择、类型筛选、采集结果及权限
SQL 不可见	角色是否允许查看语句
采样失败	数据库报错、账号读取权限、连接与结构
更新后未变化	是否选对来源和对象、文件定位信息是否保留、导入结果
对象名相同但内容不同	对照应用系统、数据源、Schema 和物理名称

相关文档：关联数据标准、配置采集。