共用方式為

st_union_agg 函数

适用于：检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 17.1 及更高版本

重要

此功能目前以公共预览版提供。

返回列中所有几何图形的逐点并集；如果列是零行或只包含 NULL 值，则返回 NULL。

语法

st_union_agg ( geoCol )

论据

  • geoCol：一列BINARY、GEOMETRY或STRING值，用于表示几何对象。

退货

GEOMETRY 类型的值，表示列中所有几何图形的逐点并集。

输出 GEOMETRY 始终为二维。

如果列包含零行或仅NULL包含值，则函数返回NULL。

错误条件

例子

-- Returns union of multiple geometries from column.
> SELECT st_astext(st_union_agg(st_geomfromtext(*))) FROM (SELECT * FROM VALUES('POINT(-5 -5)'),('MULTIPOINT(1 2,8 8,5 9,-7 -7,EMPTY)'),('MULTILINESTRING(EMPTY,(5 5,9 9),(9 9,15 15))'),('POLYGON((0 0,10 0,10 10,0 10,0 0))'));
  GEOMETRYCOLLECTION(MULTIPOINT((-7 -7),(-5 -5)),LINESTRING(10 10,15 15),POLYGON((0 0,10 0,10 10,0 10,0 0)))
-- Returns NULL for empty result set.
> SELECT st_union_agg(st_geomfromtext(geom)) FROM (SELECT 'POINT(1 1)' as geom WHERE false);
  NULL