跳到主要内容
哒哒星球DADA PLANET

Skill · 已公开版本

bigquery-troubleshooting · 定位失败或变慢的数据作业

结合作业信息、执行图与症状排查失败、延迟和费用尖峰。

先看看示例

作者提供的示例,实际效果取决于你的输入和使用工具。

输入

编辑构造材料(未运行):
同一 SQL:基线扫描 20 GB、运行 12 秒;本次扫描 20 GB、运行 80 秒;本次执行图标记 slot_contention=true;未提供容量变更记录。

输出

编辑示例 · 未运行
主要证据:扫描量相同,运行耗时增加,且出现 slot_contention。
当前判断:优先调查资源竞争;数据扫描量增长没有得到这些材料支持。
尚不能确定:是同时间并发增加还是 reservation 配置变化,需要补同时间负载和配置记录。

方法说明

结合作业信息、执行图与症状排查失败、延迟和费用尖峰。

具体任务

解释同一查询为何变慢:结合作业信息、执行图与症状排查失败、延迟和费用尖峰。

必需材料

慢作业 ID、区域与完整错误或执行统计

可比较的正常作业及 SQL

可选材料

近期配置变更

执行图与 reservation 信息

使用门槛

能读取 BigQuery 作业详情,或导出不含敏感行数据的统计。

这个 Skill 额外提供的方法

先找可比较的快基线,再分辨扫描、slot、排队和阶段瓶颈变化;费用诊断看实际资源消耗。

编辑示例(未运行)

解释同一查询为何变慢

任务:解释同一查询为何变慢

输入:
编辑构造材料(未运行):
同一 SQL:基线扫描 20 GB、运行 12 秒;本次扫描 20 GB、运行 80 秒;本次执行图标记 slot_contention=true;未提供容量变更记录。

结果片段:
主要证据:扫描量相同,运行耗时增加,且出现 slot_contention。
当前判断:优先调查资源竞争;数据扫描量增长没有得到这些材料支持。
尚不能确定:是同时间并发增加还是 reservation 配置变化,需要补同时间负载和配置记录。

这是依据固定入口方法撰写的编辑示例,没有运行上游 Skill 或访问真实账号。先找可比较的快基线,再分辨扫描、slot、排队和阶段瓶颈变化;费用诊断看实际资源消耗。

首次任务

请使用已安装的 bigquery-troubleshooting Skill。
任务:解释同一查询为何变慢。

我的必需材料:
- 慢作业 ID、区域与完整错误或执行统计:[粘贴我的实际材料或路径;缺少时写明]
- 可比较的正常作业及 SQL:[粘贴我的实际材料或路径;缺少时写明]

可选补充:
- 近期配置变更:[可选,未提供时不要假定存在]
- 执行图与 reservation 信息:[可选,未提供时不要假定存在]

请先确认材料是否足够,只处理我提供的范围。先做证据诊断,不把相关性当根因;容量规划和结构改造需移交对应任务。交付可直接审阅的分析结论和证据,明确尚未执行或验证的部分。不要代入页面例子的虚构数据。
验收:
1. 结论包含快慢基线和原始作业证据。
2. 资源消耗与合同价格没有混为同一原因。
3. 无法确认的根因明确列出下一项所需证据。

验收方法

结论包含快慢基线和原始作业证据。

资源消耗与合同价格没有混为同一原因。

无法确认的根因明确列出下一项所需证据。

依赖与准备

需要完整 Skill 目录,保留 references/performance_resource_contention.md、references/performance_config_changed.md、references/query_plan_execution_graph.md、references/cost_compute_ondemand.md 等引用。需要 bq/gcloud 或 SDK 认证以及 jobs 读取权限;对应性能/费用 references 必须保留。入口浮动安装工具应固定版本再使用。

使用边界

先做证据诊断,不把相关性当根因;容量规划和结构改造需移交对应任务。

需要 bq 或客户端认证及作业详情;与容量规划和结构改造的目标不同。

页面中的例子为编辑撰写,未运行上游 Skill;不代表平台兼容认证或生产实测。

排错

只给一句查询慢:先补 job ID、区域、基线和执行统计,再判断瓶颈。

看不到完整字节信息:检查权限及 RLS 等可见性限制,不能用缺失值当零。

固定来源

https://github.com/google/skills/blob/2964a69c4d4a27632a43d60dab5f4f645f2a82df/skills/cloud/bigquery-troubleshooting/SKILL.md

许可

Apache-2.0。许可原文:https://github.com/google/skills/blob/2964a69c4d4a27632a43d60dab5f4f645f2a82df/LICENSE

仓库热度

google/skills 仓库 20,504 Stars(2026-09-30 核验);这是父仓库指标,不是单个 Skill 的评分。