適用対象:
Databricks SQL
Databricks Runtime 17.1 以降" とマークされているチェック
Important
この機能は パブリック プレビュー段階です。
注
この機能は、Databricks SQL クラシック ウェアハウスでは使用できません。 Databricks SQL ウェアハウスの詳細については、 SQL ウェアハウスの種類に関するページを参照してください。
列内のすべてのジオメトリのエンベロープを返します。列に行が 0 の場合、または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