Partilhar via

st_union_agg Função

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

Important

Este recurso está no Public Preview.

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