適用於:
Databricks SQL
Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲,請參閱 SQL 倉儲類型。
傳回數據行中所有幾何的包絡,如果該列有零行數據,或僅包含NULL值,則傳回NULL。
Syntax
st_envelope_agg ( geoCol )
Arguments
-
geoCol:GEOMETRY列。
Returns
資料欄中所有幾何的包絡的類型為 GEOMETRY 的值。
如果欄位有零個資料列或只包含NULL值,則函式會傳回NULL。
錯誤條件
- 如果輸入包含具有不同 SRID 值的幾何,函 式會傳回ST_DIFFERENT_SRID_VALUES。
Examples
-- 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