dbt 平台任务故障排查

原名：troubleshooting-dbt-job-errors

从真实运行日志和代码变更定位任务失败，找不到证据时保留未知结论。

中文 Skills 技能说明

适用于 dbt Cloud 或平台任务失败，不代替本地开发错误诊断。提供项目、任务运行记录与脱敏日志，技能先定位失败节点，再区分基础设施、编译和数据测试问题，输出证据、原因判断与修复建议。不能为了消除红灯直接关闭测试或改坏业务规则。平台查询需要自有 API 权限，可从用户导出日志开始；重跑、改配置和修数据需明确授权。日志中密钥和客户信息应先脱敏。

上游能力依据

上游原始适用说明：Diagnoses dbt Cloud/platform job failures by analyzing run logs, querying the Admin API, reviewing git history, and investigating data issues. Use when a dbt Cloud/platform job fails and you need to diagnose the root cause, especially when error messages are unclear or when intermittent failures occur. Do not use for local dbt development errors.

上游 SKILL.md 主要章节（保留原文标题）：

• When to Use
• The Iron Rule
• Rationalizations That Mean STOP
• Workflow
• Step 1: Gather Job Run Information
• If dbt MCP Server Admin API Available
• Without MCP Admin API
• Step 2: Classify the Error
• Step 3: Investigate Root Cause
• For Infrastructure Errors

使用边界

先核对运行环境、账号、区域、依赖和最小权限。创建资源、改配置、发布服务或产生费用前必须让使用者确认。

作者、翻译与许可证

原作者

dbt Labs 与 dbt-agent-skills contributors

中文翻译

CEOFans翻译

许可证

Apache-2.0

上游来源

https://github.com/dbt-labs/dbt-agent-skills/tree/168a2b0b92da59be88866257140907c206ff0e44/skills/dbt/skills/troubleshooting-dbt-job-errors

适用范围

平台：linux、macos、windows；标签：开发运维、dbt 平台任务故障排查、开源技能

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。