Filter (type de données geography)Filter (geography Data Type)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

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.A method that offers a fast, index-only intersection method to determine if a geography instance intersects another geography instance, assuming an index is available.

Retourne 1 si une instance geography entre potentiellement en intersection avec une autre instance geography.Returns 1 if a geography instance potentially intersects another geography instance. Cette méthode peut produire un retour de faux positif, et le résultat exact peut dépendre du plan.This method may produce a false-positive return, and the exact result may be plan-dependent. Retourne une valeur 0 précise (retour négatif vrai) si aucune intersection d’instances geography n’est détectée.Returns an accurate 0 value (true negative return) if there is no intersection of geography instances found.

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.In cases where an index is not available, or is not used, the method will return the same values as STIntersects() when called with the same parameters.

SyntaxeSyntax

  
.Filter ( other_geography )  

ArgumentsArguments

other_geographyother_geography
Autre instance geography à comparer à l’instance sur laquelle Filter() est appelé.Is another geography instance to compare against the instance on which Filter() is invoked.

Types de retourReturn Types

Type de retour SQL ServerSQL Server : bitSQL ServerSQL Server return type: bit

Type de retour CLR : SqlBooleanCLR return type: SqlBoolean

NotesRemarks

Cette méthode n'est pas déterministe et n'est pas précise.This method is not deterministic and is not precise.

ExemplesExamples

L'exemple suivant utilise Filter() pour déterminer si deux instances geography entrent en intersection.The following example uses Filter() to determine if two geography instances intersect each other.

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 aussiSee Also

Méthodes étendues sur des instances Geography Extended Methods on Geography Instances
STIntersects (type de données geography)STIntersects (geography Data Type)