st_union_agg Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 e superior

Observação

Esse recurso não está disponível nos armazéns Databricks SQL Classic. Para saber mais sobre os armazéns SQL do Databricks, consulte Tipos de armazém SQL.

Devolve a união pontual de todas as geometrias na coluna, ou NULL se a coluna tiver zero linhas, ou contiver apenas NULL valores.

Syntax

st_union_agg ( geoCol )

Arguments

  • geoCol: Uma coluna do tipo GEOMETRY, representando objetos de geometria.

Returns

Um valor do tipo GEOMETRY, que representa a união pontual de todos os GEOMETRY valores na coluna.

A saída GEOMETRY é sempre bidimensional.

A função retorna NULL se a coluna tiver zero linhas ou contiver apenas NULL valores.

Condições de erro

  • Se dois GEOMETRY valores na coluna de entrada tiverem valores SRID diferentes, a função retornará ST_DIFFERENT_SRID_VALUES.

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