top-hitters, opérateur

Retourne une approximation pour les valeurs distinctes les plus populaires, ou les valeurs avec la plus grande somme, dans l’entrée.

Notes

top-hitters utilise un algorithme d’approximation optimisé pour les performances lorsque les données d’entrée sont volumineuses. L’approximation est basée sur l’algorithme Count-Min-Sketch .

Syntax

T|top-hittersNumberOfValuesofValueExpression [ bySummingExpression ]

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
T	string	✔️	Expression tabulaire d’entrée.
NumberOfValues	int, long ou real	✔️	Nombre de valeurs distinctes de ValueExpression.
ValueExpression	string	✔️	Expression sur la table d’entrée T dont les valeurs distinctes sont retournées.
Somme de l’expression	string		Si elle est spécifiée, une expression numérique sur la table d’entrée T dont la somme par valeur distincte de ValueExpression détermine les valeurs à émettre. S’il n’est pas spécifié, le nombre de valeurs distinctes de ValueExpression est utilisé à la place.

Remarques

La première syntaxe (aucune SommeingExpression) est conceptuellement équivalente à :

T|summarizeC``=``count()byValueExpression|topNumberOfValues par Cdesc

La deuxième syntaxe (avec SummingExpression) est conceptuellement équivalente à :

T|summarizeS``=``sum(*SummingExpression*)byValueExpression|topNumberOfValues par Sdesc

Exemples

Obtenir les éléments les plus fréquents

L’exemple suivant montre comment trouver les 5 premiers types de tempêtes.

Exécuter la requête

StormEvents
| top-hitters 5 of EventType 

Sortie

Type d’événement	approximate_count_EventType
Vent d’orage	13015
Grêle	12711
Crue soudaine	3688
Sécheresse	3616
Météo hivernale	3349

Obtenir les meilleurs frappeurs en fonction de la valeur de colonne

L’exemple suivant montre comment rechercher les États avec le plus d’événements « Vent d’orage ».

Exécuter la requête

StormEvents
| where EventType == "Thunderstorm Wind"
| top-hitters 10 of State 

Sortie

State	approximate_sum_State
TEXAS	830
GEORGIE	609
MICHIGAN	602
IOWA	585
PENNSYLVANIA	549
ILLINOIS	533
NEW YORK	502
VIRGINIA	482
KANSAS	476
OHIO	455