SuperAPI AI 工具集

debugging-dbt-errors

数据与分析

查看项目

更新于 10-15 16:48

技能介绍

用途:系统化调试并修复 dbt 错误,适用于任务中出现“fix”“error”“broken”“failing”“debug”“wrong”等情况。

主要能力:覆盖编译错误、数据库错误、依赖错误和测试失败;先读完整错误、检查上游模型,再分析错误类型并定位修复点。

典型流程:先用 dbt compile --select <model_name> 或 dbt build --select <model_name> 获取完整错误;数据问题用 dbt show --select <model_name> --limit 20 或 dbt show --inline "select * from {{ ref('model_name') }} where <condition>" --limit 10 查看实际数据;阅读 target/compiled/<project>/<path>/<model_name>.sql 中的编译 SQL;用 grep 检查上游引用和下游影响。

常见修复:列不存在需核对上游输出列;列名歧义加表别名;类型不匹配加显式 CAST;除零用 NULLIF(divisor, 0);Jinja 错误检查 {{ }} 与 {% %} 配对。

关键限制:修复后必须运行 dbt build --select <model_name> 验证,compile 不足以确认;若失败三次以上应停止并重新评估整体方案;构建通过不代表结果正确,仍需用 dbt show 和 dbt test 校验数据。反模式包括未理解错误就随机修改、未查上游就断定当前模型错误、未读完整错误、未运行构建就宣称修复、陷入小修小补而不重新评估。

原文未提供安装方式、收费信息或具体平台要求,均暂未提供。