从Adobe Analytics转BigQuery新手：WITHIN语句语法错误排查求助

嗨，刚从Adobe Analytics转投BigQuery的话，确实会碰到一些语法上的小差异，别慌，你的问题其实很常见！

你遇到的Syntax error: Unexpected keyword WITHIN报错，核心原因是**WITHIN RECORD是BigQuery Legacy SQL（旧版语法）的写法**，而现在BigQuery默认使用的是Standard SQL（新版标准语法），这两种语法不兼容，直接跑旧代码自然会报错。

下面给你两种解决思路，优先推荐第一种：

方法一：改用Standard SQL语法（推荐） #

Google现在重点维护的是Standard SQL，它功能更强大、兼容性更好，也更符合现代SQL标准。针对你的需求，我们可以用**子查询结合UNNEST**来替代WITHIN RECORD的逻辑，具体代码如下：

SELECT 
  fullVisitorId, 
  visitId, 
  hits.hitNumber, 
  hits.time,
  -- 从当前hits的customDimensions数组中提取index=1的value，没有匹配则返回NULL
  (SELECT cd.value 
   FROM UNNEST(hits.customDimensions) cd 
   WHERE cd.index = 1 
   LIMIT 1) AS cd2n
FROM `bigquery-public-data.google_analytics_sample.ga_sessions_*`,
UNNEST(hits) as hits
LIMIT 10;

这段代码的逻辑和你原代码完全一致：对每一条展开的hits记录，遍历它的customDimensions数组，找到index为1的条目并取出value；如果没有匹配的条目，cd2n会自动返回NULL。

方法二：切换到Legacy SQL模式（不推荐） #

如果你暂时想沿用类似Adobe Analytics的写法，可以切换到Legacy SQL模式，但要注意：Legacy SQL已经不再被Google重点维护，未来可能会被逐步淘汰。

操作步骤： #

1. 在BigQuery查询编辑器界面，点击右上角的三个点图标，选择「查询设置」
2. 在弹出的窗口里，把「SQL方言」改成「Legacy SQL」并保存
3. 调整代码（Legacy SQL用FLATTEN替代UNNEST）：

SELECT 
  fullVisitorId, 
  visitId, 
  hits.hitNumber, 
  hits.time,
  max(IF(hits.customDimensions.index = 1, hits.customDimensions.value, NULL)) WITHIN RECORD as cd2n
FROM FLATTEN([bigquery-public-data.google_analytics_sample.ga_sessions_*], hits)
LIMIT 10;

内容的提问来源于stack exchange，提问作者Neil D