BigQuery报错：无法在重复字段customDimensions.value上关联，求解决

你遇到的Cannot join on repeated field 'customDimensions.value'错误，核心原因是**customDimensions是BigQuery中的重复字段（数组类型）**——每个GA会话可能包含多个自定义维度条目，直接在WHERE子句中引用它的子字段（比如value、index）会因为字段结构不匹配而报错。

修正后的SQL语句 #

SELECT 
  fullVisitorId, 
  visitNumber, 
  totals.pageviews, 
  cd.value as client_id 
FROM (
  SELECT * 
  FROM TABLE_DATE_RANGE([xxxxxxx.ga_sessions_], TIMESTAMP('2017-01-01'), TIMESTAMP('2018-01-01'))
), UNNEST(customDimensions) as cd
WHERE cd.index = 2 
  AND cd.value IN (SELECT STRING(id) FROM [table])
GROUP BY 1,2,3,4

关键修改点说明 #

• 用UNNEST(customDimensions) as cd展开重复字段：把每个会话中的多个自定义维度条目拆分成单独的行，这样就能正常引用cd.index和cd.value这些子字段了。
• 调整WHERE子句的字段引用：原来的customDimensions.index和customDimensions.value改成通过别名cd来引用，避免直接操作重复字段。
• 保持原有的时间范围、ID匹配和分组逻辑不变，确保查询结果符合你的需求。

如果你的场景中一个会话可能有多个符合index=2的自定义维度（虽然GA里每个index在一个会话中应该唯一），GROUP BY会帮你去重；如果不需要分组，可以根据实际需求去掉GROUP BY（但要注意重复数据的问题）。

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