STRelate (tipo de datos geometry)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstancePunto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

Devuelve 1 si una instancia de geometry está relacionada con otra instancia de geometry, donde la relación está definida por un valor de matriz de patrones DE-9IM (Dimensionally Extended 9 Intersection Model); en caso contrario, devuelve 0.

Sintaxis

  
.STRelate ( other_geometry, intersection_pattern_matrix )

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

other_geometry
Es otra instancia de geometry con la que se compara la instancia en la que se invoca STRelate().

intersection_pattern_matrix
Es una cadena de tipo nchar(9) que codifica valores aceptables para el dispositivo de matriz de patrones DE-9IM entre las dos instancias de geometry.

Observaciones

Este método siempre devuelve NULL si no coinciden los identificadores de referencia espacial (SRID) de las instancias de geometry. Este método produce una excepción ArgumentException si la matriz no tiene el formato correcto.

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: bit

Tipo de valor devuelto de CLR: SqlBoolean

Ejemplos

En el ejemplo siguiente se usa STRelate() para comprobar si dos instancias de geometry no están combinadas en el espacio mediante un patrón DE-9IM explícito.

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

Consulte también

Métodos de OGC en instancias de geometry