BigQuery标准SQL更新时报无效时间戳错误（未操作dateOfBirth字段）

你遇到的这个问题其实是BigQuery UPDATE机制的一个常见“坑”——虽然你只修改了emailHashCode字段，但BigQuery在执行UPDATE时，会重写符合WHERE条件的整行数据，而不是只更新指定字段。这就意味着，即使你没碰dateOfBirth，如果该行的这个字段本身存储了超出BigQuery合法Timestamp范围的值，重写时就会触发校验报错。

第一步：定位无效的dateOfBirth记录 #

先运行下面的SQL，找出那些不符合Timestamp范围的记录（建议加上唯一标识字段，方便定位具体数据）：

SELECT dateOfBirth, customer_id
FROM `customer.customers`
WHERE dateOfBirth < TIMESTAMP('0001-01-01 00:00:00') 
   OR dateOfBirth > TIMESTAMP('9999-12-31 23:59:59.999999')

第二步：修复无效值 #

根据业务需求处理这些无效的Timestamp，比如如果业务允许空值，可以直接转为NULL：

UPDATE `customer.customers`
SET dateOfBirth = NULL
WHERE dateOfBirth < TIMESTAMP('0001-01-01 00:00:00') 
   OR dateOfBirth > TIMESTAMP('9999-12-31 23:59:59.999999')

如果有明确的业务规则可以修正为合法日期（比如替换为某个默认日期），也可以直接写入对应合法值。

第三步：重新执行原UPDATE语句 #

等修复完dateOfBirth的无效值后，再运行你原来的更新语句，就不会再触发这个错误了。

另外，顺便给你的原SQL提个小优化：子查询可以简化，不用关联整张表，直接用UNNEST的结果关联，效率会更高：

UPDATE `customer.customers` 
SET emailHashCode = TO_HEX(SHA256(e.emailAddress)) 
FROM `customer.customers`, UNNEST(emailAddresses) AS e 
WHERE emailHashCode IS NULL

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