STWithin (tipo de datos geometry)

  • Artigo

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 se encuentra totalmente dentro de otra instancia de geometry; en caso contrario, devuelve 0. El comando STWithin distingue mayúsculas de minúsculas.

Sintaxis

  
.STWithin ( other_geometry )

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 STWithin().

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: bit

Tipo de valor devuelto de CLR: SqlBoolean

Observaciones

Este método siempre devuelve NULL si no coinciden los identificadores de referencia espacial (SRID) de las instancias de geometry.

Ejemplos

En el ejemplo siguiente se usa STWithin() para comprobar si, dadas dos instancias de geometry, la primera de ellas está totalmente dentro de la segunda.

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

Consulte también

Información general sobre los índices espaciales
Métodos de OGC en instancias de geometry