GA4/BigQuery：如何自动展开所有事件的event_params嵌套行

要实现自动展开GA4嵌套表中所有event_params字段，同时适配后续新增的参数，无需手动逐个指定，核心是用动态SQL结合BigQuery的嵌套数组拆分+动态列生成逻辑，具体实现如下：

动态展开脚本 #

以下脚本会自动扫描表中所有已存在的event_params.key，生成对应的展开语句，同时保留原事件的核心字段：

DECLARE param_keys ARRAY<STRING>;
DECLARE sql_query STRING;

-- 1. 抓取所有不重复的event_params参数名
SET param_keys = ARRAY(
  SELECT DISTINCT param.key
  FROM `你的项目ID.你的数据集ID.ga4_events表名`
  CROSS JOIN UNNEST(event_params) AS param
);

-- 2. 拼接动态SQL：生成每个参数的展开逻辑
SET sql_query = """
SELECT
  -- 保留原事件基础字段，可根据需求增减
  event_name,
  event_timestamp,
  user_id,
  user_pseudo_id,
  -- 动态生成的参数列
  """ || ARRAY_TO_STRING(
    ARRAY(
      SELECT CONCAT(
        "MAX(IF(param.key = '", key, "', COALESCE(",
        "param.value.string_value, ",
        "CAST(param.value.int_value AS STRING), ",
        "CAST(param.value.float_value AS STRING), ",
        "CAST(param.value.double_value AS STRING)",
        "), NULL)) AS `", key, "`"
      )
      FROM UNNEST(param_keys) AS key
    ),
    ",\n  "
  ) || """
FROM `你的项目ID.你的数据集ID.ga4_events表名`
CROSS JOIN UNNEST(event_params) AS param
GROUP BY
  event_name,
  event_timestamp,
  user_id,
  user_pseudo_id
""";

-- 3. 执行动态生成的SQL
EXECUTE IMMEDIATE sql_query;

关键细节说明 #

• 自动适配新增参数：每次执行脚本时，都会重新扫描表中所有event_params.key，新增的参数会自动被加入展开列，无需修改代码。
• 值类型兼容：用COALESCE自动取第一个非空的value字段（string/int/float/double），并统一转为STRING类型，避免类型不匹配问题；如果需要保留原参数类型，可根据参数特性单独处理，但会增加复杂度，建议统一转STRING后再按需转换。
• 合并事件行：因为UNNEST会把单个事件拆成多行（每个参数一行），所以用GROUP BY合并回原事件行，MAX函数用于提取参数值（同一个事件的同一个参数只会有一个有效值，MAX不影响结果）。
• 自定义基础字段：SELECT和GROUP BY中的基础字段（如event_name）可根据你的表结构调整，确保所有非聚合字段都在GROUP BY中。

可选优化：处理重复参数 #

如果存在同一个事件中同一个参数名重复出现的特殊场景，可将MAX替换为ARRAY_AGG来收集所有值：

"ARRAY_AGG(DISTINCT COALESCE(param.value.string_value, CAST(param.value.int_value AS STRING), ...)) AS `", key, "`"

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