如何确认BigQuery查询是否使用BI Engine？排查BI Engine未生效问题

一、确认查询是否由BI Engine返回 #

有三种可靠方式可以验证：

• 通过作业统计信息查询
  你使用的INFORMATION_SCHEMA.JOBS_BY_PROJECT查询是标准验证方式：当BI Engine被成功调用时，bi_engine_statistics字段会返回包含bi_engine_mode（FULL表示全量命中、PARTIAL表示部分命中）、命中行数等的结构体；如果该字段为NULL，说明查询完全未使用BI Engine。
• 查看控制台作业详情
  在BigQuery控制台的「作业」列表找到目标查询，进入详情页后，「查询统计信息」板块会明确标注是否使用BI Engine，以及具体的命中数据、时间节省情况。
• 检查查询执行计划
  执行查询时切换到「执行计划」标签，若出现BI Engine Retrieve类的节点，说明查询已命中BI Engine缓存。

二、排查BI Engine未触发的原因（bi_engine_statistics为NULL） #

如果查询未用到BI Engine，常见原因包括：

• 数据表未正确加入BI Engine
  确认目标表已添加到BI Engine预留容量中，且状态为「已就绪」。注意：BI Engine仅支持非分区表或分区表的指定分区缓存，若添加分区表时未指定具体分区，缓存无法生效。
• 查询语法不符合BI Engine限制
  BI Engine不支持部分复杂查询场景，例如：
  • 使用ARRAY_AGG、多层嵌套子查询等超出支持范围的语法
  • 引用了未加入BI Engine的表、视图、临时表或外部表
  • 查询包含无法被BI Engine下推的聚合、排序操作（仅LIMIT操作支持直接命中）
• 缓存未完成预热
  刚将表添加到BI Engine后，需要几分钟完成数据加载（预热），此期间查询不会命中缓存，等待后重试即可。
• BI Engine预留容量不足
  若预留容量无法覆盖查询涉及的数据量，BigQuery会自动切换回常规查询模式，需检查并调整容量配置。
• 查询参数禁用了BI Engine
  确保查询未使用ALLOW_LITERALS等会屏蔽BI Engine的参数，且使用的是标准SQL而非Legacy SQL。

你用于检查的查询语句： #

SELECT
  creation_time,
  job_id,
  bi_engine_statistics
FROM
  `region-us`.INFORMATION_SCHEMA.JOBS_BY_PROJECT
WHERE
  creation_time BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
  AND CURRENT_TIMESTAMP()
  AND job_type = "QUERY"
  -- and job_id = 'XXXXXXXX'
ORDER BY creation_time DESC;

查询结果截图显示所有查询的bi_engine_statistics字段均为NULL，说明这些查询均未触发BI Engine。

内容的提问来源于stack exchange，提问作者Ayan Chakraborty