STUnion (tipo di dati geometry)

  • Articolo

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Endpoint di analisiSQL in Microsoft FabricWarehouse in Microsoft Fabric

Restituisce un oggetto che rappresenta l'unione di un'istanza geometry con un'altra istanza geometry.

Sintassi

  
.STUnion ( other_geometry )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

other_geometry
Altra istanza geometry per formare un'unione con l'istanza sulla quale viene chiamato STUnion().

Tipi restituiti

Tipo SQL Server restituito: geometry

Tipo CLR restituito: SqlGeometry

Osservazioni:

Questo metodo restituisce sempre Null se gli identificatori SRID delle istanze geometry non corrispondono. Il risultato può contenere segmenti di arco circolare solo se le istanze di input contengono segmenti di arco circolare.

Esempi

R. Calcolo dell'unione di due istanze Polygon

Nell'esempio seguente viene utilizzato STUnion() per calcolare l'unione di due istanze Polygon.

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 0 2, 2 2, 2 0, 0 0))', 0);  
SET @h = geometry::STGeomFromText('POLYGON((1 1, 3 1, 3 3, 1 3, 1 1))', 0);  
SELECT @g.STUnion(@h).ToString();

B. Calcolo dell'unione di un'istanza Polygon e un'istanza CurvePolygon

Nell'esempio seguente viene restituita un'istanza GeometryCollection che contiene un segmento di arco circolare.

 DECLARE @g geometry = 'CURVEPOLYGON(CIRCULARSTRING(0 -4, 4 0, 0 4, -4 0, 0 -4))';  
 DECLARE @h geometry = 'POLYGON((5 -1, 5 -3, 7 -3, 7 -1, 5 -1))';  
 SELECT @g.STUnion(@h).ToString();

STUnion() restituisce un risultato che contiene un segmento di arco circolare perché l'istanza che ha richiamato STUnion() contiene un segmento di arco circolare.

Vedi anche

Metodi OGC sulle istanze di geometria