Teilen über

st_union_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 die punktweise Vereinigung aller Geometrien in der Spalte zurück, oder NULL wenn die Spalte null Zeilen enthält oder nur NULL Werte enthält.

Syntax

st_union_agg ( geoCol )

Arguments

  • geoCol: Eine Spalte vom Typ GEOMETRY, die Geometrieobjekte darstellt.

Returns

Ein Wert vom Typ GEOMETRY, der die punktweise Vereinigung aller GEOMETRY Werte in der Spalte darstellt.

Die Ausgabe GEOMETRY ist immer zweidimensional.

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

Fehlerbedingungen

  • Wenn zwei GEOMETRY Werte in der Eingabespalte unterschiedliche SRID-Werte aufweisen, gibt die Funktion ST_DIFFERENT_SRID_VALUES zurück.

Examples

-- Returns union of multiple geometries from column.
> SELECT st_astext(st_union_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))'));
  GEOMETRYCOLLECTION(MULTIPOINT((-7 -7),(-5 -5)),LINESTRING(10 10,15 15),POLYGON((0 0,10 0,10 10,0 10,0 0)))
-- Returns NULL for empty result set.
> SELECT st_union_agg(st_geomfromtext(geom)) FROM (SELECT 'POINT(1 1)' as geom WHERE false);
  NULL
  • Last updated on