st_union Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 e superior

Devolve a união do conjunto de pontos dos dois valores de entrada GEOMETRY como uma geometria 2D.

Syntax

st_union ( geo1, geo2 )

Arguments

• geo1: O primeiro GEOMETRY valor.
• geo2: O segundo GEOMETRY valor.

Returns

Um valor do tipo GEOMETRY, que representa a união de conjuntos de pontos dos dois valores de entrada GEOMETRY como uma geometria 2D.

O SRID do valor retornado GEOMETRY é o SRID comum dos dois valores de entrada GEOMETRY .

A função retorna NULL se qualquer uma das entradas for NULL.

Condições de erro

• Se as geometrias de entrada não tiverem o mesmo valor SRID, a função retornará ST_DIFFERENT_SRID_VALUES.

Examples

-- Returns union of multipoint and polygon.
> SELECT st_astext(st_union(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
  GEOMETRYCOLLECTION(POINT(-1 8),POINT(5 6),POLYGON((0 0,0 10,10 0,0 0)))
-- Returns union of two overlapping polygons.
> SELECT st_astext(st_union(st_geomfromtext('POLYGON((0 0,5 0,5 5,0 5,0 0))'),st_geomfromtext('POLYGON((3 3,8 3,8 8,3 8,3 3))')));
  POLYGON((5 3,5 0,0 0,0 5,3 5,3 8,8 8,8 3,5 3))

Funções relacionadas

• st_intersection Função
• st_union_agg Função