查看和分析血缘
本指南统一说明数据目录、血缘地图和应用场景中常用的血缘图操作，包括搜索、分析方向、层级、深度、筛选、导出、二级血缘、代码裁剪和差异比较。
阅读图形时先区分三个维度：方向是相对当前对象看上游、下游或全链路；层级是看系统/Schema、表等实体、字段等属性，或加工算子；深度是沿关系向外展开的步数。改变其中一项不会自动改变另外两项，屏幕上未显示的节点也不能直接判定为不存在。
血缘搜索
全局搜索
全局搜索是从血缘地图快速打开对象血缘的入口。可搜索 Schema、实体、属性和脚本文件：
- Schema、实体和属性支持多选，并可同时查看其全链路血缘。
- 脚本文件会在新的血缘视图中打开详细关系。
- 多选前确认对象所属系统和命名空间，避免把同名对象放入同一分析。
图内搜索
图内搜索只在当前已打开的血缘图中定位对象，可搜索 Schema、实体、属性或标签并高亮其位置。它不会扩大当前血缘深度，也不会加载尚未展示的对象。
上游 下游和全链路
当前实体是血缘图的分析基准。以当前实体为参照：
- 上游分析展示产生或影响当前实体的对象。
- 下游分析展示当前实体可能影响的对象。
- 全链路展示与当前实体相连的全部上下游关系。
在图中切换分析方向后，应再次确认当前实体标识。多个对象同时作为当前实体时，导出和影响分析的范围也会随之变化。
血缘层级
层级控制血缘图的对象颗粒度。血缘地图默认可从平台级或 Schema 级开始，通过钻取进入实体级和属性级，也可以从属性级向上返回实体级或 Schema 级。
在本页中，Schema 是数据库组织表等对象的逻辑名称范围；“实体”主要指表、视图、报表或文件等可独立识别的对象；“属性”指对象中的字段等组成项；“算子”指加工过程中可解释的计算或转换步骤。这些名称描述图中的对象类型，不表示四种不同的授权产品。
| 层级 | 适合回答的问题 |
|---|---|
| Schema 级 | 数据在系统或数据库区域之间如何流动 |
| 实体级 | 哪些表、视图、报表或文件存在依赖 |
| 属性级 | 某个字段或指标具体来自哪里、流向哪里 |
| 算子级 | 字段在 SQL 加工步骤中如何计算或传递 |
血缘深度
深度表示从当前实体向上游或下游展开多少组直接关联对象。深度越大，加载的对象和关系越多。建议先以较小深度定位关键路径，再逐步增加，避免大图中难以识别重点。
筛选过滤
筛选支持按实体类型或标签隐藏和显示对象，并支持单选、多选。被取消显示的项数会在筛选图标上提示。
例如链路为 A → B → C，隐藏中间实体 B 后，画面可显示为 A → C；关闭筛选后恢复原始展示。筛选只改变当前视图，不会删除 B 或底层关系。
常见用途包括隐藏 ETL 临时表、仅查看核心表、按责任域或系统标签聚焦一段链路。
图形控制
| 控件 | 作用 |
|---|---|
| SQL | 在脚本文件血缘中显示或隐藏 SQL 窗口 |
| 放大和缩小 | 调整对象显示比例 |
| 全屏 | 扩大血缘图工作区域 |
| 显示 | 控制临时对象、中文名称、间接关系等内容 |
| 编辑 | 进入受控的血缘编辑状态 |
编辑状态还提供新建、撤销、重做、删除和保存。删除只允许作用于本次编辑新增的对象或连线，不能删除画布原有内容。
导出影响报告
影响报告默认以当前实体为基准，可以配置：
- 表级或字段级对象颗粒度。
- 上游、下游或全链路范围。
- 对象类型。
- 是否排除中间处理过程。
- 当前页面支持的导出格式。
报告可以包含因画面控制而未显示的对象，因此报告范围可能大于当前屏幕。也可以右键选择图中对象，通过“影响分析”生成该对象全部深度的影响报告。
当图中存在多个当前实体时，系统会分别生成对应报告；没有明确当前实体时，范围可能按图中全部对象计算。导出前必须检查分析基准。
二级血缘和算子血缘
“二级血缘”是在当前对象关系图之下继续展开的处理细节视图，不是第二套独立血缘数据。表、字段和算子支持进入二级血缘；其中“算子血缘”把 SQL 或脚本中的计算、转换步骤与输入、输出对象关联，用于解释字段如何产生或传递。字段旁的 fx 标识表示存在计算表达式，可以高亮某一算子的上下游，并进入算子级关系。
二级血缘用于解释处理过程，不应脱离完整 SQL、变量和调度上下文单独作为业务结论。
代码裁剪
代码裁剪从完整脚本中提取与选中实体或属性相关的处理片段，便于定位该对象的输入或后续使用。这里的“裁剪”只改变分析时展示的代码范围，不表示修改或删减源脚本。
查看实体上游处理逻辑
- 在血缘图中选择目标实体。
- 打开对象的右键菜单并选择“代码裁剪”。
- 选择输入分析。
- 查看向该实体写入数据的相关代码片段。
查看字段下游使用逻辑
- 展开实体并选择目标字段或指标。
- 打开“代码裁剪”。
- 选择输出分析。
- 查看后续视图、计算或连接中使用该字段的代码片段。
代码裁剪适合口径穿透和跨步骤逻辑整合。结果是聚焦片段，不等同于完整可执行脚本。
比较文件和血缘差异
代码差异
在血缘空间打开血缘文件的比较功能，可以逐行查看两个文件修订之间的变化。页面使用语法着色和差异高亮帮助识别字段、表达式和结构变化。
血缘差异
血缘差异根据两个解析结果比较节点和关系的变化。页面可用颜色区分新增、修改和删除对象，并通过切换控件查看两侧状态。
比较前确认两次解析使用相同的采集范围、命名空间和解析规则，避免把配置变化误判为业务变化。
结果验证
- 当前实体、所属系统和命名空间正确。
- 上下游方向与实际数据处理方向一致。
- 层级和深度足以回答问题，没有因筛选遗漏关键对象。
- 二级血缘和代码片段与完整脚本可以相互印证。
- 影响报告的基准、方向、颗粒度和范围正确。
- 差异比较两侧的采集与解析条件具有可比性。