SQLink 应用场景
“应用场景”是 SQLink 为特定分析目标保存的对象范围和查看方式，把数据目录中的数据源、数据实体和指标组织到一个可持续分析的业务范围中。它不是数据开发任务，也不复制数据或替代采集和解析；场景使用已经进入 SQLink 的元数据与血缘关系回答特定问题。
使用前提
- 目标数据源、实体或指标已进入数据目录。
- 关键血缘已完成解析，并经过抽样检查。
- 当前用户对场景对象具有查看权限；创建、编辑和删除权限由管理员分配。
- 已明确场景负责人、分析目标和处理结果的接收人。
场景中的对象
创建场景时可从数据目录选择数据源、数据实体和指标。对象是否可选取取决于采集范围、数据权限和当前目录内容。添加前应核对对象所属系统和命名空间，避免选择同名但不同环境的对象。
场景支持关注和分享。关注用于持续查看本人关心的场景；分享前应确认接收人具有场景内对象的数据权限，分享操作不会扩大其原有权限。
通用场景
通用场景适合围绕一条核心业务链路持续观察相关对象和变更事件。“核心链路”指本场景重点关注的对象及其上下游依赖，不表示 SQLink 会自动判断哪条链路在业务上最重要。
创建场景
- 进入应用场景，选择新建通用场景。
- 填写能够说明业务范围的名称和描述。
- 从数据目录添加需要关注的数据源、实体或指标。
- 核对对象所属系统、环境和上下游范围。
- 保存场景，进入场景详情检查核心链路。
创建后，具有相应权限的用户可继续编辑范围、删除场景或进入管理视图。删除前应确认场景不再承担持续监测或协作任务。
核心链路与变更事件
在场景详情中检查核心对象及其上下游关系。发生对象或链路变更时，可在场景中查看相关事件并判断是否需要通知责任人。场景内出现的事件是排查入口，仍需结合任务日志和实际发布记录确认变更原因。
影响分析
影响分析用于变更前评估和变更后核对。分析对象不同，检查重点也不同。
| 分析对象 | 主要用途 | 重点检查 |
|---|---|---|
| 数据源 | 评估数据源结构或采集范围变化 | 受影响实体、任务、报表和下游系统 |
| 数据实体 | 评估表、视图等对象变化 | 字段级或实体级下游影响 |
| 数据指标 | 评估指标口径或依赖变化 | 指标来源、计算链路和消费对象 |
| 任务 | 评估调度或转换任务变化 | 输入、输出和依赖任务 |
事前影响分析
- 选择计划变更的数据源、实体、指标或任务。
- 设置分析方向、层级和深度。
- 检查受影响的直接下游和完整下游链路。
- 识别关键系统、报表、任务和责任人。
- 保存或导出分析结果，交由相关负责人复核。
- 在变更方案中记录风险和回退安排。
事后影响核对
变更完成后重新运行相同范围的影响分析，对比新增、消失或方向变化的关系。若结果与事前评估不一致，先检查采集和解析是否已更新，再判断是否为实际变更遗漏。
影响广播
“影响广播”是把已识别的潜在受影响对象或范围通知相关人员的协作动作，不是血缘计算本身。系统可基于已识别的影响范围辅助发起广播。自动广播与手工广播的触发条件、接收范围和发送方式可能不同，使用前应由管理员确认当前配置。广播只用于告知和留痕，不能替代正式变更审批或责任人确认。
质量分析
质量分析从血缘结构检查孤表、环线、断点以及上下游对象的一致性。
孤表分析
孤表是未形成预期上下游关系的实体。发现孤表时依次检查：对象是否应参与数据加工、相关代码或任务是否已采集、命名空间是否一致，以及解析是否成功。业务上确实独立的表不应被误判为缺陷。
环线分析
环线表示链路中存在循环关系。循环可能来自实际迭代处理，也可能由对象映射或解析错误造成。应结合任务顺序、代码和调度记录判断，不要仅凭图形删除关系。
断点分析
断点表示预期连续的链路在某处中断。重点检查上游输出与下游输入的名称映射、临时表、跨数据源连接、脚本变量和缺失的采集任务。
一致性分析
一致性检查关注上下游字段的名称、数据类型和长度。发现差异时需判断这是合理转换还是潜在风险，并结合转换代码确认。类型或长度不同不必然代表错误。
结果验证
- 场景名称和描述能清楚说明业务问题。
- 场景对象来自正确的系统、环境和命名空间。
- 影响分析的方向、层级和深度符合变更范围。
- 广播接收人和通知边界已经人工复核。
- 孤表、环线、断点和一致性问题均有调查结论或处理人。
- 修复采集、映射或代码后已重新运行分析并比较结果。
常见问题
找不到要添加的对象
检查对象是否已完成元数据采集、是否进入数据目录，以及当前用户是否具有查看权限。不要用名称相近的其他环境对象代替。
影响范围明显过小
检查分析深度和筛选条件，再检查相关解析任务、命名空间及元数据覆盖率。未发现影响不等于不存在尚未采集的链路。
质量问题数量突然增加
先核对最近的采集、解析或映射变更，再抽样检查问题对象。不要在确认原因前批量手工补线。