STContains (tipo de dados geometry)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Ponto de extremidade de análise de SQL no Microsoft Fabric Warehouse no Microsoft Fabric

Retornará 1 se uma instância de geometry contiver completamente outra instância de geometry. Retornará 0 se isso não ocorrer.

Sintaxe

  
.STContains ( other_geometry )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

other_geometry
É outra instância de geometry a ser comparada com a instância na qual STContains() é invocado.

Tipos de retorno

Tipo de retorno do SQL Server: bit

Tipo de retorno do CLR: SqlBoolean

Comentários

STContains() sempre retornará nulo se as SRIDs (IDs de referência espacial) das instâncias de geometry não forem correspondentes.

Exemplos

O exemplo a seguir usa STContains() para testar duas instâncias de geometry a fim de verificar se a primeira instância contém a 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('POINT(1 1)', 0);  
SELECT @g.STContains(@h);  

Consulte Também

Visão geral de índices espaciais
Métodos OGC em instâncias geometry