Compartilhar via

st_union_agg Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Esse recurso está em Visualização Pública.

Observação

Esse recurso não está disponível em databricks SQL Classic warehouses. Para saber mais sobre os sql warehouses do Databricks, consulte os tipos de sql warehouse.

Retorna a união pontual de todas as geometrias na coluna ou NULL se a coluna tem zero linhas ou contém apenas NULL valores.

Syntax

st_union_agg ( geoCol )

Arguments

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

Returns

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

A saída GEOMETRY é sempre bidimensional.

A função retornará 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