has_any, opérateur

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Filtre un jeu d’enregistrements pour les données avec n’importe quel ensemble de chaînes ne respectant pas la casse. has_anyrecherche des termes indexés, où un terme indexé est de trois caractères ou plus. Si votre terme est inférieur à trois caractères, la requête analyse les valeurs de la colonne, ce qui est plus lent que la recherche du terme dans l’index de terme.

Pour plus d’informations sur d’autres opérateurs et pour déterminer l’opérateur le plus approprié pour votre requête, consultez les opérateurs de chaîne de type de données.

Astuces pour les performances

Remarque

Lorsque plus de 128 termes de recherche sont utilisés, l’optimisation de la recherche d’index de texte est désactivée, ce qui peut entraîner une réduction des performances des requêtes.

Syntaxe

Expression T | where col ... has_any (,)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
T	string	✔️	Entrée tabulaire à filtrer.
col	string	✔️	Colonne par laquelle filtrer.
expression	scalaire ou tabulaire	✔️	Expression qui spécifie les valeurs pour lesquelles effectuer une recherche. Chaque expression peut être une valeur scalaire ou une expression tabulaire qui produit un ensemble de valeurs. Si une expression tabulaire a plusieurs colonnes, la première colonne est utilisée. La recherche prend en compte jusqu’à 10 000 valeurs distinctes.

Remarque

Une expression tabulaire inline doit être placée entre parenthèses doubles. Consultez l’exemple.

Retours

Lignes dans T dont le prédicat est défini sur true.

Exemples

Liste des scalaires

La requête suivante montre comment utiliser has_any avec une liste séparée par des virgules de valeurs scalaires.

Exécuter la requête

StormEvents 
| where State has_any ("CAROLINA", "DAKOTA", "NEW") 
| summarize count() by State

Sortie

State	count_
NEW YORK	1750
CAROLINE DU NORD	1721
DAKOTA DU SUD	1 567
NEW JERSEY	1044
CAROLINE DU SUD	915
DAKOTA DU NORD	905
NOUVEAU-MEXIQUE	5:27
NEW HAMPSHIRE	394

Tableau dynamique

La requête suivante montre comment utiliser has_any avec un tableau dynamique.

Exécuter la requête

StormEvents 
| where State has_any (dynamic(['south', 'north']))
| summarize count() by State

Sortie

State	count_
CAROLINE DU NORD	1721
DAKOTA DU SUD	1 567
CAROLINE DU SUD	915
DAKOTA DU NORD	905
ATLANTIQUE SUD	193
ATLANTIQUE NORD	188

La même requête peut également être écrite avec une instruction let.

Exécuter la requête

let areas = dynamic(['south', 'north']);
StormEvents 
| where State has_any (areas)
| summarize count() by State

Sortie

State	count_
CAROLINE DU NORD	1721
DAKOTA DU SUD	1 567
CAROLINE DU SUD	915
DAKOTA DU NORD	905
ATLANTIQUE SUD	193
ATLANTIQUE NORD	188

Expression tabulaire

La requête suivante montre comment utiliser has_any avec une expression tabulaire inline. Notez qu’une expression tabulaire inline doit être placée entre parenthèses doubles.

Exécuter la requête

StormEvents 
| where State has_any ((PopulationData | where Population > 5000000 | project State))
| summarize count() by State

Sortie

State	count_
TEXAS	4701
ILLINOIS	2022
MISSOURI	2016
GEORGIE	1983
MINNESOTA	1881
...	...

La même requête peut également être écrite avec une instruction let. Notez que les parenthèses doubles fournies dans le dernier exemple ne sont pas nécessaires dans ce cas.

Exécuter la requête

let large_states = PopulationData | where Population > 5000000 | project State;
StormEvents 
| where State has_any (large_states)
| summarize count() by State

Sortie

State	count_
TEXAS	4701
ILLINOIS	2022
MISSOURI	2016
GEORGIE	1983
MINNESOTA	1881
...	...