Teilen über


st_envelope_agg-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Gibt den Umschlag aller Geometrien in der Spalte zurück, oder NULL wenn die Spalte null Zeilen enthält oder nur NULL Werte enthält.

Syntax

st_envelope_agg ( geoCol )

Arguments

  • geoCol: Eine GEOMETRY Spalte.

Returns

Ein Wert vom Typ GEOMETRY, der den Umschlag aller Geometrien in der Spalte darstellt.

Die Funktion gibt zurück NULL , wenn die Spalte null Zeilen enthält oder nur NULL Werte enthält.

Fehlerbedingungen

  • Wenn die Eingabe Geometrien mit unterschiedlichen SRID-Werten enthält, gibt die Funktion ST_DIFFERENT_SRID_VALUES zurück.

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