Filter (type de données geography)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Méthode rapide d’intersection d’index uniquement, qui permet de déterminer si une instance geography entre en intersection avec une autre instance geography, en supposant qu’un index soit disponible.

Retourne 1 si une instance geography entre potentiellement en intersection avec une autre instance geography. Cette méthode peut produire un retour de faux positif, et le résultat exact peut dépendre du plan. Retourne une valeur 0 précise (retour négatif vrai) si aucune intersection d’instances geography n’est détectée.

Dans les cas où un index n’est pas disponible ou n’est pas utilisé, la méthode retourne les mêmes valeurs que STIntersects() quand elle est appelée avec les mêmes paramètres.

Syntaxe

  
.Filter ( other_geography )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

other_geography
Autre instance geography à comparer à l’instance sur laquelle Filter() est appelé.

Types de retour

Type de retour SQL Server : bit

Type de retour CLR : SqlBoolean

Remarques

Cette méthode n'est pas déterministe et n'est pas précise.

Exemples

L'exemple suivant utilise Filter() pour déterminer si deux instances geography entrent en intersection.

CREATE TABLE sample (id int primary key, g geography);  
INSERT INTO sample VALUES  
   (0, geography::Point(45, -120, 4326)),  
   (1, geography::Point(45, -120.1, 4326)),  
   (2, geography::Point(45, -120.2, 4326)),  
   (3, geography::Point(45, -120.3, 4326)),  
   (4, geography::Point(45, -120.4, 4326));  
  
CREATE SPATIAL INDEX sample_idx on sample(g);  
SELECT id  
FROM sample   
WHERE g.Filter(geography::Parse(  
   'POLYGON((-120.1 44.9, -119.9 44.9, -119.9 45.1, -120.1 45.1, -120.1 44.9))')) = 1;

Voir aussi

Méthodes étendues sur des instances geography
STIntersects (type de données geography)