STUnion (type de données geometry)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstancePoint de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

Retourne un objet qui représente l’union entre une instance geometry et une autre instance geometry.

Syntaxe

  
.STUnion ( other_geometry )  

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez Versions antérieures de la documentation.

Arguments

other_geometry
Autre instance geometry qui permet de former une union avec l’instance sur laquelle STUnion() est appelé.

Types de retour

Type de retour SQL Server : geometry

Type de retour CLR : SqlGeometry

Remarques

Cette méthode retourne toujours une valeur Null si les SRID (ID de référence spatiale) des instances geometry ne correspondent pas. Le résultat peut contenir des segments d'arc de cercle uniquement si les instances d'entrée contiennent des segments d'arc de cercle.

Exemples

R. Calcul de l'union de deux instances Polygon

L'exemple suivant utilise STUnion() pour calculer l'union de deux instances 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. Calcul de l'union d'une instance Polygon avec une instance CurvePolygon

L'exemple suivant retourne une instance GeometryCollection qui contient un segment d'arc de cercle.

 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() retourne un résultat qui contient un segment d'arc de cercle car l'instance qui a appelé STUnion() contient un segment d'arc de cercle.

Voir aussi

Méthodes OGC sur des instances geography