Partilhar via


CollectionAggregate (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

Cria uma instância de GeometryCollection de um conjunto de tipos de geometry.

Sintaxe

  
CollectionAggregate ( geometry_operand )  

Argumentos

geometry_operand
É uma coluna da tabela do tipo geometria que representa um conjunto de objetos geometria a ser listado na instância de GeometryCollection.

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 uma instância GeometryCollection que contém um CurvePolygon e um Polygon.

-- Setup table variable for CollectionAggregate 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 CollectionAggregate on @Geom.shape column  
SELECT geometry::CollectionAggregate(shape).ToString()  
FROM @Geom;

Consulte Também

Métodos estendidos de geometria estática