View a markdown version of this page

ST_Union - Amazon Redshift

O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na publicação do blog publicada em 30 de junho de 2025.

ST_Union

ST_Union retorna uma geometria que representa a união de duas geometrias. Ou seja, as geometrias de entrada são mescladas para produzir uma geometria sem sobreposições.

Sintaxe

ST_Union(geom1, geom2)

Argumentos

geom1

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

geom2

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

Tipo de retorno

GEOMETRY

O valor do identificador do sistema de referência espacial (SRID - spatial reference system identifier) da geometria retornada é o valor do SRID das geometrias de entrada.

Nulo será retornado se geom1 ou geom2 for nulo.

Se geom1 e geom2 estiverem vazios, será retornada uma geometria vazia.

Um erro será retornado se geom1 e geom2 não tiverem o mesmo valor do identificador do sistema referência espacial (SRID -spatial reference system identifier).

Se geom1 ou geom2 for um conjunto de geometrias, linestring ou multilinestring, será retornado um erro.

Se geom1 ou geom2 não forem uma geometria bidimensional (2D), será retornado um erro.

Exemplos

O SQL a seguir retorna a geometria não vazia que representa a união de duas geometrias de entrada.

SELECT ST_AsEWKT(ST_Union(ST_GeomFromText('POLYGON((0 0,100 100,0 200,0 0))'), ST_GeomFromText('POLYGON((0 0,10 0,0 10,0 0))')));
st_asewkt ------------------------- POLYGON((0 0,0 200,100 100,5 5,10 0,0 0))