Operatore top-hitters

Si applica a: ✅Microsoft Fabric✅

Restituisce un'approssimazione per i valori distinti più diffusi o i valori con la somma più grande nell'input.

Nota

top-hitters usa un algoritmo di approssimazione ottimizzato per le prestazioni quando i dati di input sono di grandi dimensioni. L'approssimazione si basa sull'algoritmo Count-Min-Sketch .

Sintassi

T|top-hittersNumberOfValuesof ValueExpression [ bySummingExpression ]

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
T	string	✔️	Espressione tabulare di input.
NumberOfValues	int, long o real	✔️	Numero di valori distinti di ValueExpression.
ValueExpression	string	✔️	Espressione sulla tabella di input T i cui valori distinti vengono restituiti.
SummingExpression	string		Se specificato, un'espressione numerica sulla tabella di input T la cui somma per valore distinto di ValueExpression stabilisce i valori da generare. Se non specificato, viene invece usato il conteggio di ogni valore distinto di ValueExpression .

Nota

• Quando si include SummingExpression nella sintassi, la query equivale a:

  T | summarize S = sum(SummingExpression) by ValueExpression | top NumberOfValues by S desc

• Quando non si include SummingExpression nella sintassi, la query equivale a:

  T | summarize C = count() by ValueExpression | top NumberOfValues by C desc

Esempi

Negli esempi di questa sezione viene illustrato come usare la sintassi per iniziare.

Gli esempi in questo articolo usano tabelle disponibili pubblicamente, ad esempio la tabella StormEvents in Analisi meteo dati di esempio.

Ottenere i primi 2 eventi in base ai totali

Questo esempio riepiloga i dati degli eventi storm calcolando il numero totale di eventi per ogni tipo di evento. La query seleziona quindi i primi due tipi di evento con il numero totale massimo di eventi.

StormEvents
| summarize TotalEventId = sum(EventId) by EventType
| top 2 by TotalEventId desc

Output

EventType	TotalEventId
Vento di tempesta	562,509,013
Grandine	474,690,007

Ottenere gli elementi più frequenti

Questo esempio mostra come trovare i primi 5 tipi di tempeste.

StormEvents
| top-hitters 5 of EventType 

Output

EventType	approximate_count_EventType
Vento di tempesta	13015
Grandine	12711
Piena improvvisa	3688
Siccità	3616
Clima invernale	3349

Ottenere i primi hitter in base al valore della colonna

Questo esempio mostra come trovare gli Stati con i più eventi Wind tuono.

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

Output

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