关于BigQuery中EXTRACT与DATE函数的语法问题求助

问题原因 #

你遇到的情况是因为BigQuery的自动推荐语法混淆了Legacy SQL和Standard SQL的规则。带AT TIME ZONE的EXTRACT写法属于旧版Legacy SQL，但当前BigQuery默认使用Standard SQL，两种模式语法规则差异极大，直接套用Legacy语法自然会触发报错。

正确用法（Standard SQL） #

EXTRACT函数 #

Standard SQL中，时区转换需要先作用在timestamp表达式上，再用EXTRACT提取对应时间部分：

-- 示例：提取纽约时区下的小时数
EXTRACT(HOUR FROM TIMESTAMP "2024-05-20 12:00:00 UTC" AT TIME ZONE "America/New_York")

核心区别：AT TIME ZONE是修饰timestamp表达式的，不是跟在FROM后的子句。

DATE函数 #

同理，带时区转换的DATE函数正确写法如下：

-- 示例：将UTC时间转为纽约时区的日期
DATE(TIMESTAMP "2024-05-20 23:00:00 UTC" AT TIME ZONE "America/New_York")

若无需时区转换，直接使用DATE(timestamp_expr)即可。

类似语法差异案例 #

Legacy SQL和Standard SQL的函数语法差异不止这两个：

• TIMESTAMP函数：Legacy支持TIMESTAMP(string_expr, tz)，Standard需用TIMESTAMP(string_expr) AT TIME ZONE tz或PARSE_TIMESTAMP(format, string_expr, tz)
• 字符串格式化函数：Legacy的STRING(timestamp_expr, tz)在Standard中要改为FORMAT_TIMESTAMP(format, timestamp_expr, tz)
• 聚合函数：Legacy的COUNT(DISTINCT x LIMIT n)在Standard中不支持，需用子查询实现限制逻辑

避坑建议 #

1. 优先参考BigQuery官方Standard SQL文档，不要依赖自动补全的推荐语法
2. 确认查询使用Standard SQL：控制台查询编辑器上方选择"Standard SQL"，或在查询开头加#standardSQL强制指定
3. 迁移Legacy SQL代码时，可使用BigQuery自带的SQL迁移工具自动转换大部分语法

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