Udostępnij za pośrednictwem

bin()

  • Artykuł

Zaokrągla wartości w dół do liczby całkowitej wielokrotności danego rozmiaru pojemnika.

Często używane w połączeniu z .summarize by ... Jeśli masz rozproszony zestaw wartości, zostaną one pogrupowane w mniejszy zestaw określonych wartości.

Funkcje bin() i floor() są równoważne

Składnia

bin(Wartość,roundTo)

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
wartość int, long, real, timespan lub datetime ✔️ Wartość, która ma być zaokrąglana w dół.
roundTo int, long, real, or timespan ✔️ "Rozmiar pojemnika", który dzieli wartość.

Zwraca

Najbliższa wielokrotność roundTo poniżej wartości. Wartości null, rozmiar pojemnika o wartości null lub ujemny rozmiar pojemnika będą powodować wartość null.

Przykłady

Pojemnik liczbowy

Uruchamianie zapytania

print bin(4.5, 1)

Dane wyjściowe

print_0
4

Przedział czasu

Uruchamianie zapytania

print bin(time(16d), 7d)

Dane wyjściowe

print_0
14:00:00:00

Przedział daty/godziny

Uruchamianie zapytania

print bin(datetime(1970-05-11 13:45:07), 1d)

Dane wyjściowe

print_0
1970-05-11T00:00:00Z

Tworzenie tabeli z pojemnikami o wartości null

Jeśli w tabeli znajdują się wiersze dla pojemników bez odpowiedniego wiersza, zalecamy wypełnienie tabeli tymi pojemnikami. Poniższe zapytanie analizuje silne zdarzenia burz wiatrowych w Kalifornii na tydzień w kwietniu. Jednak w niektórych dniach nie ma żadnych zdarzeń.

Uruchamianie zapytania

let Start = datetime('2007-04-07');
let End = Start + 7d;
StormEvents
| where StartTime between (Start .. End)
| where State == "CALIFORNIA" and EventType == "Strong Wind"
| summarize PropertyDamage=sum(DamageProperty) by bin(StartTime, 1d)

Dane wyjściowe

StartTime Uszkodzenie mienia
2007-04-08T00:00:00Z 3000
2007-04-11T00:00:00Z 1000
2007-04-12T00:00:00Z 105000

Aby reprezentować cały tydzień, następujące zapytanie dopełnia tabelę wyników wartością null dla brakujących dni. Oto szczegółowe wyjaśnienie procesu:

  1. union Użyj operatora , aby dodać więcej wierszy do tabeli.
  2. Operator range tworzy tabelę zawierającą pojedynczy wiersz i kolumnę.
  3. Operator mv-expandrange w funkcji tworzy tyle wierszy, ile jest przedziałów między StartTime i EndTime.
  4. Użyj wartości typu z PropertyDamage .0
  5. Operator summarize grupuje pojemniki z oryginalnej tabeli na tabelę utworzoną union przez wyrażenie. Ten proces zapewnia, że dane wyjściowe mają jeden wiersz na przedział, którego wartość to zero lub oryginalna liczba.

Uruchamianie zapytania

let Start = datetime('2007-04-07');
let End = Start + 7d;
StormEvents
| where StartTime between (Start .. End)
| where State == "CALIFORNIA" and EventType == "Strong Wind"
| union (
    range x from 1 to 1 step 1
    | mv-expand StartTime=range(Start, End, 1d) to typeof(datetime)
    | extend PropertyDamage=0
    )
| summarize PropertyDamage=sum(DamageProperty) by bin(StartTime, 1d)

Dane wyjściowe

StartTime Uszkodzenie mienia
2007-04-07T00:00:00Z 0
2007-04-08T00:00:00Z 3000
2007-04-09T00:00:00Z 0
2007-04-10T00:00:00Z 0
2007-04-11T00:00:00Z 1000
2007-04-12T00:00:00Z 105000
2007-04-13T00:00:00Z 0
2007-04-14T00:00:00Z 0