bin()

Область применения: ✅Microsoft Fabric

округляет значения до целого числа, кратного указанному размеру группы.

Часто используется в сочетании с summarize by .... Если у вас есть разбросанный набор значений, они будут сгруппированы в меньший набор определенных значений.

bin() Функции floor() эквивалентны

Синтаксис

bin( ценность,roundTo)

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Возвраты

Ближайшее число, кратное roundTo и меньшее value. При указании значения NULL, размера ячейки NULL или отрицательного значения размера ячейки возвращается значение NULL.

Примеры

В следующем примере показана bin() функция с числовыми данными.

print bin(4.5, 1)

Выходные данные

В следующем примере показана функция с данными bin() интервала времени.

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

Выходные данные

В следующем примере показана функция с данными bin() datetime.

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

Выходные данные

Если в таблице есть строки для ячеек без соответствующей строки, рекомендуется заполнить таблицу этими ячейками. Следующий запрос смотрит на сильные штормовые события в Калифорнии на неделю в апреле. Однако в некоторые дни не существует событий.

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)

Выходные данные

Чтобы представить полную неделю, следующий запрос заполняет таблицу результатов значениями NULL в течение отсутствующих дней. Ниже приведены пошаговые объяснения процесса.

1. union Используйте оператор, чтобы добавить в таблицу дополнительные строки.
2. Оператор range создает таблицу с одной строкой и одним столбцом.
3. Оператор mv-expand над range функцией создает столько строк, сколько между ними StartTimeесть ячейкиEndTime.
4. Используйте для PropertyDamage значение 0.
5. Оператор summarize группирует ячейки из исходной таблицы в таблицу, созданную выражением union . Этот процесс гарантирует, что выходные данные будут содержать одну строку для каждого интервала, значение которой равно нулю или исходному количеству.

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)

Выходные данные