STRelate (tipo de dados geometry)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzurePonto de extremidade de análises SQL no Microsoft FabricWarehouse no Microsoft Fabric

Retornará 1 se uma instância de geometry tiver relação com outra instância de geometry, e a relação for definida por um valor de matriz do padrão DE-9IM (Dimensionally Extended 9 Intersection Model), caso contrário, retornará 0.

Sintaxe

  
.STRelate ( other_geometry, intersection_pattern_matrix )  

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 STRelate() é invocado.

intersection_pattern_matrix
É uma cadeia de caracteres do tipo nchar(9) que codifica os valores aceitáveis do dispositivo da matriz do padrão DE-9IM entre as duas instâncias de geometria.

Comentários

Esse método sempre retornará nulo se as SRIDs (IDs de referência espacial) das instâncias de geometry não forem correspondentes. Esse método vai gerar uma ArgumentException se a matriz não estiver bem formada.

Tipos de retorno

Tipo de retorno do SQL Server: bit

Tipo de retorno do CLR: SqlBoolean

Exemplos

O exemplo a seguir usa STRelate() para testar duas instâncias de geometria quanto à separação espacial usando um padrão 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 Também

Métodos OGC em instâncias geometry