该技能用于 BigQuery 遥测数据的检索与分析,提供工具选型、环境准备和高效 SQL 查询的最佳实践。
用途:诊断作业性能、排查资源争用、审计容量与成本、分析存储用量。
工具选型:INFORMATION_SCHEMA 适合历史分析、队列比较、时间线与多作业聚合;REST API(jobs.api、reservation.api)适合单作业点查和实时阶段瓶颈诊断;Cloud Monitoring 适合实时告警与集群级仪表盘。
环境准备:需安装并配置 Google Cloud SDK,执行 gcloud config set project {project_id},启用 bigquery.googleapis.com 和 monitoring.googleapis.com,按需完成 gcloud auth login 或 gcloud auth application-default login,并配置相应 IAM 角色(如 roles/bigquery.jobUser、roles/bigquery.resourceViewer、roles/monitoring.viewer)。
单作业排查优先使用 bq show --location={location} -j {project_id}:{job_id}。
查询要点:INFORMATION_SCHEMA 查询必须带 region 或 dataset 限定符;优先选最小权限范围(如 _BY_USER、dataset 级、_BY_PROJECT);必须按 creation_time 或 usage_date 过滤;聚合计算开销时排除 SCRIPT;避免 SELECT *;复杂查询前先 dry run。结果不缓存,按需查询每次至少计费 10 MB。region 限定符不分层,多区域不含单区域,且不能跨区域 join。
安装命令:npx skills add google/skills --skill bigquery-observability --skill bigquery-optimization --skill bigquery-troubleshooting。