STRelate (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 1 se un'istanza geometry è correlata a un'altra istanza geometry. La relazione è definita da un valore della matrice del modello DE-9IM (Dimensionally Extended 9 Intersection Model). In caso contrario, restituisce 0.

Sintassi

  
.STRelate ( other_geometry, intersection_pattern_matrix )

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 da confrontare con l'istanza sulla quale viene chiamato STRelate().

intersection_pattern_matrix
Stringa di tipo nchar(9) che codifica valori accettabili per il dispositivo a matrice del modello DE-9IM tra le due istanze geometry.

Osservazioni:

Questo metodo restituisce sempre Null se gli identificatori SRID delle istanze geometry non corrispondono. Questo metodo genererà un'eccezione ArgumentException se la matrice non è formattata in modo corretto.

Tipi restituiti

Tipo SQL Server restituito: bit

Tipo CLR restituito: SqlBoolean

Esempi

Nell'esempio seguente viene usato STRelate() per verificare se due istanze geometry sono disgiunte a livello spaziale usando un modello DE-9IM esplicito.

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****');

Vedi anche

Metodi OGC sulle istanze di geometria