Partilhar via


UnionAggregate (tipo de dados geometry)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Banco de Dados SQL no Microsoft Fabric

Executa uma operação de união em um conjunto de objetos de geometria.

Sintaxe

  
UnionAggregate ( geometry_operand )  

Argumentos

geometry_operand
É uma coluna de tabela do tipo geometria que contém o conjunto de objetos de geometria no qual uma operação de união deve ser executada.

Tipos de retorno

Tipo de retorno do SQL Server: geometry

Exceções

Gera uma FormatException quando há valores de entrada que não são válidos. Confira STIsValid (tipo de dados geometry)

Comentários

O método retornará nulo quando a entrada estiver vazia ou tiver SRIDs diferentes. Confira SRIDs (identificadores de referência espacial)

O método ignora entradas nulas.

Observação

O método retornará nulo se todos os valores inseridos forem nulos.

Exemplos

O exemplo a seguir retorna a união de um conjunto de objetos de geometria em uma variável de tabela.

-- Setup table variable for UnionAggregate example 
DECLARE @Geom TABLE 
( 
shape geometry, 
shapeType nvarchar(50) 
); 
INSERT INTO @Geom(shape,shapeType) 
VALUES('CURVEPOLYGON(CIRCULARSTRING(2 3, 4 1, 6 3, 4 5, 2 3))', 'Circle'), 
('POLYGON((1 1, 4 1, 4 5, 1 5, 1 1))', 'Rectangle'); 
-- Perform UnionAggregate on @Geom.shape column 
SELECT geometry::UnionAggregate(shape).ToString() 
FROM @Geom;

Consulte Também

Métodos estendidos de geometria estática