SuperAPI AI 工具集

bigquery

数据与分析

查看项目

更新于 10-15 20:09

技能介绍

用途:bigquery 是代理原生工具,直接出现在工具的可用列表中,用于查询已配置的 BigQuery 仓库分析数据。用户提出仓库 SQL、BigQuery 表、BigQuery 中的 Amplitude 事件等需求时使用。可用时直接以 SQL 调用,不要用 HTTP 绕行或脚本替代。

主要能力:

  • data-source-status --key bigquery:检查 BigQuery 凭据与项目是否已配置。
  • list-data-dictionary --search <topic>:写 SQL 前查找规范化指标与表定义。
  • search-bigquery-schema:列出数据集、数据集内表或描述表列。
  • bigquery --sql "<sql>":在确认表列名后运行真实仓库查询。

使用方式:先查数据字典确认指标定义与准确表列名,再用 search-bigquery-schema 核实数据集、表、列名,最后写 SQL。资料给出命令示例:pnpm action search-bigquery-schema;pnpm action search-bigquery-schema --dataset=product_events;pnpm action search-bigquery-schema --table=product_events.events;pnpm action search-bigquery-schema --dataset=product_events --search=rootOrganizationId。表优先级为 dbt_mart.、dbt_analytics.、dbt_staging_bigquery.、dbt_intermediate.,最后才用 analytics./amplitude./raw 表;避免 dbt_dev.*。查询大表必须加日期过滤,例如 WHERE event_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 30 DAY)。跨表关联用户时同时匹配稳定 id 与 email。

限制:不要编造数据集、表或列名;BIGQUERY_PROJECT_ID 只是默认项目。未知表列错误属可恢复信号,用 search-bigquery-schema 修正后重试。凭据、权限、配额类错误需向用户反馈。资料未提供价格、平台等其他信息。