GBQ更新Geography列报语法错误的正确实现方法

两个写法触发报错的核心问题有三个：

1. 多余嵌套括号：两次SQL都在函数参数外多套了一层括号，BigQuery会将单层括号包裹的逗号分隔内容优先识别为结构体构造语法或子查询，无法解析为合法表达式，直接触发Parenthesized expression cannot be parsed as an expression, struct constructor, or subquery报错。
2. 函数使用错误：BigQuery不存在直接接收裸坐标列表的polygon()构造函数，裸写的经纬度对不属于合法SQL表达式。
3. 格式不符合规范：
   • 用ST_GeogFromText时传入的内容不符合WKT（Well-Known Text）格式要求，缺少多边形类型前缀和正确的括号层级
   • 跨多行的字符串未用三引号包裹，SQL解析到换行时判定字符串未闭合，触发Unclosed string literal报错。

下面给两种生产环境常用的合法写法，可直接替换执行：

写法1：ST_GeogFromText 传入标准WKT（兼容性最高） #

WKT构造多边形的固定格式为POLYGON((经度 纬度, 经度 纬度, ..., 与第一个点完全一致的闭合点))，多行字符串用BigQuery支持的三引号包裹避免转义问题：

UPDATE `project.dataset.locations`
SET polygon = ST_GeogFromText("""POLYGON((
  -75.24508 40.23625,
  -75.24470 40.23633,
  -75.24464 40.23629,
  -75.24468 40.23628,
  -75.24463 40.23628,
  -75.24469 40.23624,
  -75.24468 40.23620,
  -75.24504 40.23612,
  -75.24508 40.23625
))""")
WHERE external_id = '1234'

注意：BigQuery所有地理函数默认坐标顺序为经度在前、纬度在后，写反会定位到完全错误的位置；多边形环首尾坐标必须完全一致才能正常闭合。

写法2：ST_MakePolygon 配合点数组构造（不易写错格式） #

如果不想手动拼接WKT字符串，可以先通过ST_GeogPoint构造每个坐标点，传入ST_MakeLine生成闭合线环后，再用ST_MakePolygon生成面对象：

UPDATE `project.dataset.locations`
SET polygon = ST_MakePolygon(ST_MakeLine([
  ST_GeogPoint(-75.24508, 40.23625),
  ST_GeogPoint(-75.24470, 40.23633),
  ST_GeogPoint(-75.24464, 40.23629),
  ST_GeogPoint(-75.24468, 40.23628),
  ST_GeogPoint(-75.24463, 40.23628),
  ST_GeogPoint(-75.24469, 40.23624),
  ST_GeogPoint(-75.24468, 40.23620),
  ST_GeogPoint(-75.24504, 40.23612),
  ST_GeogPoint(-75.24508, 40.23625)
]))
WHERE external_id = '1234'

这种写法不需要手动维护WKT格式，ST_MakeLine接收到点数组后会自动将最后一个点和第一个点连接形成闭合环，适合坐标点较多、容易拼错WKT的场景。

• 地理构造函数传参时不要额外嵌套无意义的括号，单参数函数仅需一层括号包裹参数即可
• BigQuery中跨行的字符串字面量必须使用三引号"""包裹，否则解析器会将换行识别为语句结束，触发字符串未闭合错误
• 禁止直接将裸经纬度列表传入地理函数，所有坐标必须先封装为合法的WKT/GeoJSON字符串，或通过ST_GeogPoint构造为点类型对象后再参与运算
• 构造多边形时如果存在内环（挖洞场景），需要在WKT的外层括号内继续追加内环的坐标组，或传入对应的线环数组给ST_MakePolygon

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