用 Google Agent Skills 写 BigQuery 查询时，可以让 bigquery-basics 按 GoogleSQL 生成或复核 SQL，再到 BigQuery Studio 运行。先用内联样例确认聚合口径，再换成真实表。
用内联数据约定输入和结果
下面这个练习不用提前建数据集，也不需要引用任何外部表。我们预先准备2条api记录、1条web记录，目标是按服务维度统计总请求数。注意跑完整流程之前，得先有一个支持提交查询作业的google cloud项目。
请使用 bigquery-basics，检查这条 GoogleSQL 是否按 service 分组并正确加总 hits。请指出每个分组的预期值。
WITH events AS (
SELECT * FROM UNNEST([
STRUCT('api' AS service, 2 AS hits),
STRUCT('api' AS service, 3 AS hits),
STRUCT('web' AS service, 4 AS hits)
])
)
SELECT service, SUM(hits) AS total_hits
FROM events
GROUP BY service
ORDER BY service;
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 BigQuery Studio 运行并核对
选好要跑作业的项目，打开BigQuery Studio新建空白SQL查询，把刚才的语句粘贴到编辑区点运行就可以。对照之前的样例输入，跑出来的结果一共两行，api对应的总请求数是5，web对应的总请求数是4。
换成真实表前检查哪些条件？
切到真实表之前，挨个核对这几项：实际表的字段名、字段类型、数据集所在的区域位置。替换完真实表之后，先看编辑器自动弹出的扫描数据量估算，再按业务需求补全必要的过滤条件。要是运行时跳出权限错误，分两步排查：先确认当前账号能不能提交查询作业，再确认账号有没有目标表的读取权限。
结果不对时先验算哪一部分？
先单独跑WITH后面的明细查询，核对返回的是不是2条api记录、1条web记录。再跑带分组逻辑的完整语句，核对两个分组的汇总值。要是准备对接真实表，可以在语句里加COUNT(*)，同步检查每个分组对应的记录条数，别光看总数漏了重复数据的问题。
怎么把练习换成真实表？
先开表预览核对service和hits两个字段的类型。下面示例假设真实表还有一个DATE类型的event_date字段，用日期条件限定统计范围，按实际结构替换表路径、字段和日期参数就行。如果这张表是按事件日期分区的，直接用分区字段限制需要读取的分区就好。
SELECT service, COUNT(*) AS source_rows, SUM(hits) AS total_hits FROM `my-project.my_dataset.events` WHERE event_date >= DATE '2026-11-01' AND event_date <h3>先看估算，再运行作业</h3> <p>在编辑器里确认SQL通过校验，同时查看系统估算的数据处理量。查询设置里可以指定处理区域，按需计费的场景下还能限制最大计费字节数。注意处理区域必须和引用数据集所在的区域保持一致。要是查询触发字节上限告警，先检查选的列、日期范围和分区条件有没有问题，再考虑要不要调整上限。</p>
