GitHubContribuisci in GitHub: Modifica in linea

bin ()

Arrotonda i valori a un numero intero multiplo di una determinata dimensione bin.

Utilizzato di frequente in combinazione con summarize by .... Se si dispone di una serie di valori a dispersione, questi verranno raggruppati in una serie più piccola di valori specifici.

I valori null, una dimensione bin null o una dimensione bin negativa risulteranno null.

Alias della funzione floor() .

Sintassi

bin(valore,roundTo)

Argomenti

  • value: un numero, una data o un periodo di tempo.
  • roundTo: la "dimensione bin". Un numero o un periodo di tempo che divide valore.

Restituisce

Il multiplo più vicino di roundTo sotto valore.

(toint((value/roundTo))) * roundTo`

Esempi

Espressione Risultato
bin(4.5, 1) 4.0
bin(time(16d), 7d) 14d
bin(datetime(1970-05-11 13:45:07), 1d) datetime(1970-05-11)

La seguente espressione calcola un istogramma di durate, con una dimensione bucket di 1 secondo:

events    
    | project original_time
    | where original_time > ago(30d)    
    //--- USER Criteria He
    | summarize Hits=count() by bin(original_time, 1s)

Risultati

Visualizzazione dei primi 3 risultati dell'intero set.

ora_originale Visite
2023-06-07T11:32:16.000Z 84
2023-06-07T11:32:17.000Z 114
2023-06-07T11:32:18.000Z 92