适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
返回列中所有几何图形的逐点并集;如果列是零行或只包含 NULL
值,则返回 NULL
。
语法
st_union_agg ( geoCol )
论据
-
geoCol
:一列BINARY
、GEOMETRY
或STRING
值,用于表示几何对象。
退货
GEOMETRY
类型的值,表示列中所有几何图形的逐点并集。
输出 GEOMETRY
始终为二维。
如果列包含零行或仅NULL
包含值,则函数返回NULL
。
错误条件
- 如果输入和
GEOMETRY
几何图形具有不同的 SRID 值,函数将返回 ST_DIFFERENT_SRID_VALUES。
例子
-- 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