在线 SQL 血缘
在线 SQL 血缘面向数据开发和分析人员，用于在不创建正式解析任务的情况下快速检查一段 SQL 的输入、输出、中间过程和字段关系。在线结果适合开发核对和问题分析；需要持续管理的代码应进入正式采集与解析流程。
使用前提
- 已取得待分析 SQL 的合法使用权限，并已移除密码、令牌等敏感信息。
- 已知 SQL 所属数据库类型或适用的解析引擎。
- 如需关联 DAM 元数据，已确认相应命名空间和默认 Schema。
首次操作可直接使用快速开始的教学样例，先识别输入、输出和字段，再分析真实业务代码。
解析 SQL
- 进入在线 SQL 血缘页面。
- 选择 SQL 类型或与语法匹配的解析引擎。
- 将 SQL 输入编辑区。
- 如需整理缩进和换行，执行美化 SQL。
- 打开解析设置，按实际需要配置间接关系和元数据关联选项。
- 执行解析。
- 在结果区切换表级或字段级视图并核对关系。
解析设置
| 设置 | 作用 | 使用建议 |
|---|---|---|
| 显示间接关系 | 展示通过中间表达式或过程推导的关系 | 排查复杂转换时启用；阅读主链路时可关闭 |
| 强制关联元数据 | 将解析节点绑定到已采集的元数据 | 仅在命名空间和 Schema 明确时使用 |
| 命名空间 | 限定对象所属的逻辑环境 | 必须与目标元数据的规划一致 |
| 默认 Schema | 为 SQL 中未写 Schema 的对象补充上下文 | 按 SQL 实际执行环境填写，不作猜测 |
强制关联元数据时，如果命名空间或默认 Schema 配置错误，可能关联到错误对象或产生无法匹配的节点。首次使用应选择一段已知结果的 SQL 做小范围验证。
阅读解析结果
- 蓝色节点表示输入对象。
- 绿色节点表示输出对象。
- 黄色节点表示解析过程中形成的中间对象或过程。
- 实线表示直接关系。
- 虚线表示间接关系。
可在表级和字段级之间切换。表级用于快速理解整体输入输出，字段级用于核对列的来源和转换。完整链路开关用于控制是否展示通过中间节点展开的关系；复杂 SQL 下应结合筛选和缩放逐段检查。
运行历史
运行历史用于回看已执行的在线解析。打开历史记录后，核对 SQL、解析类型、执行时间和结果是否属于当前任务。历史记录可能包含业务代码，查看和共享仍受数据权限与保密要求约束。
结果验证
- 输入和输出对象与 SQL 的
FROM、JOIN、INSERT或创建语句一致。 - 字段映射能解释别名、表达式和聚合结果。
- 直接关系与间接关系的显示符合当前分析目的。
- 强制关联后的对象属于正确命名空间和 Schema。
- 解析警告、未识别语句或缺失对象已经记录。
常见问题
解析失败
检查 SQL 类型、语法完整性、数据库特有语法和变量。若代码依赖运行时替换变量，应先按受控样本完成预处理，再解析可执行形态的 SQL。
节点未关联到元数据
检查元数据是否已采集，以及命名空间、默认 Schema 和对象大小写是否一致。不要为了得到连线而关联到名称相同但来源不同的对象。
解析结果过于复杂
先切换到表级视图，再关闭完整链路或间接关系，定位主输入和主输出后逐步展开。