STWithin (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 1 si une instance geometry est située complètement dans une autre instance geometry ; sinon, retourne 0. La commande STWithin respecte la casse.

Syntaxe

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

Types de retour

Type de retour SQL Server : bit

Type de retour CLR : SqlBoolean

Remarques

Cette méthode retourne toujours une valeur Null si les SRID (ID de référence spatiale) des instances geometry ne correspondent pas.

Exemples

L'exemple suivant utilise STWithin() pour tester deux instances geometry pour voir si la première instance est complètement dans la deuxième instance.

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

Voir aussi

Vue d’ensemble des index spatiaux
Méthodes OGC sur des instances geography