STRelate (type de données geometry)

  • Article

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

Retourne 1 si une instance geometry est associée à une autre instance geometry, où la relation est définie par une valeur de matrice de modèle DE-9IM (Dimensionally Extended 9 Intersection Model) ; sinon, retourne 0.

Syntaxe

  
.STRelate ( other_geometry, intersection_pattern_matrix )

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 à comparer à l’instance sur laquelle STRelate() est appelé.

intersection_pattern_matrix
Chaîne de type nchar (9) qui code des valeurs acceptables pour l’appareil de matrice de modèle DE-9IM entre les deux instances geometry.

Remarques

Cette méthode retourne toujours une valeur Null si les SRID (ID de référence spatiale) des instances geometry ne correspondent pas. Cette méthode lève ArgumentException si la matrice n’est pas bien formée.

Types de retour

Type de retour SQL Server : bit

Type de retour CLR : SqlBoolean

Exemples

L’exemple suivant utilise STRelate() pour tester la disjointure spatiale de deux instances geometry à l’aide d’un modèle DE-9IM explicite.

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(0 2, 2 0, 4 2)', 0);  
SET @h = geometry::STGeomFromText('POINT(5 5)', 0);  
SELECT @g.STRelate(@h, 'FF*FF****');

Voir aussi

Méthodes OGC sur des instances geography