STUnion (geometry-Datentyp)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceSQL Analytics-Endpunkt in Microsoft FabricWarehouse in Microsoft Fabric

Gibt ein Objekt zurück, das die Vereinigung einer geometry -Instanz mit einer weiteren geometry -Instanz darstellt.

Syntax

  
.STUnion ( other_geometry )  

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

other_geometry
Eine andere geometry -Instanz zur Vereinigung mit der Instanz, in der STUnion() aufgerufen wird.

Rückgabetypen

SQL Server-Rückgabetyp: geometry

CLR-Rückgabetyp: SqlGeometry

Hinweise

Diese Methode gibt immer NULL zurück, wenn die SRIDs (Spatial Reference IDs) der geometry -Instanzen nicht übereinstimmen. Im Ergebnis können nur dann Kreisbogensegmente enthalten sein, wenn die Eingabeinstanzen auch Kreisbogensegmente enthalten.

Beispiele

A. Berechnen der Union von zwei Polygon-Instanzen

Im folgenden Beispiel wird STUnion() zum Berechnen der Vereinigung zweier Polygon -Instanzen verwendet.

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. Berechnen der Union einer Polygon-Instanz und einer CurvePolygon-Instanz

Im folgenden Beispiel wird eine GeometryCollection -Instanz zurückgegeben, die ein Kreisbogensegment enthält.

 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() gibt ein Ergebnis zurück, das ein Kreisbogensegment enthält, da die Instanz, die STUnion() aufgerufen hat, ein Kreisbogensegment enthält.

Weitere Informationen

OGC-Methoden für geometry-Instanzen