适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
返回该列中所有几何形状的包络,或者如果该列包含零行,或仅包含NULL
值,则返回NULL
。
语法
st_envelope_agg ( geoCol )
论据
-
geoCol
:GEOMETRY
列。
退货
类型为 GEOMETRY
的值,表示列中所有几何图形的边界。
如果列包含零行或仅NULL
包含值,则函数返回NULL
。
错误条件
- 如果输入包含具有不同 SRID 值的几何图形,函数将返回 ST_DIFFERENT_SRID_VALUES。
例子
-- Returns the envelope of multiple geometries.
> SELECT st_astext(st_envelope_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))'));
POLYGON((-7 -7,-7 15,15 15,15 -7,-7 -7))
-- Returns NULL for an empty result set.
> SELECT st_envelope_agg(st_geomfromtext(geom)) FROM (SELECT 'POINT(1 1)' as geom WHERE false);
NULL