st_envelope_agg 函数

适用于： 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

相关函数

• st_envelope 函数