dbt模型血缘映射器

解决什么问题

在 dbt 项目规模扩大后，模型之间的依赖关系会快速变得复杂。一个上游模型的字段调整或逻辑重构，往往会影响下游多个下游模型，而这些依赖通常分散在 manifest.json、catalog.json 等多个工件中。手工梳理这些关系不仅耗时，还容易遗漏关键节点，导致变更影响范围判断不准确。

核心能力与工作流程

该技能通过解析 dbt Core 的 manifest.json 与 catalog.json 文件，利用官方工件 API 自动提取模型间的血缘关系。核心步骤包括：首先读取 manifest.json 中的节点定义，识别模型之间的引用关系；接着结合 catalog.json 中的元数据，构建完整的依赖图；最后生成交互式 DAG 可视化，直观展示模型层级结构。

针对模型变更场景，技能支持影响分析功能：当上游模型发生变化时，可快速定位所有直接或间接受影响的下游模型，辅助评估变更风险。整个过程基于 dbt Core 的标准工件格式，兼容本地开发环境和 dbt Cloud CLI 生成的文件。

适用边界与注意点

该工具依赖 dbt 项目正确生成的工件文件，需确保 manifest.json 与 catalog.json 为最新状态。对于包含动态生成的模型或复杂宏逻辑的项目，血缘提取可能需要额外的配置支持。此外，可视化效果基于 DAG 标准格式，不适用于非标准自定义输出的依赖关系。