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;