count_distinct() (агрегатная функция) — (предварительная версия)

Подсчитывает уникальные значения, заданные скалярным выражением, для каждой сводной группы или общее количество уникальных значений, если сводная группа опущена.

Значения NULL игнорируются и не учитываются при вычислении.

Примечание

Эта функция используется в сочетании с оператором summarize.

Если требуется только оценка количества уникальных значений, рекомендуется использовать агрегатную функцию с меньшим потреблением dcount ресурсов.

Чтобы подсчитать только записи, для которых возвращается trueпредикат , используйте агрегатную функцию count_distinctif.

Примечание

• Эта функция ограничена 100 млн уникальных значений. Попытка применить функцию к выражению, возвращающего слишком много значений, приведет к ошибке времени выполнения (HRESULT: 0x80DA0012).
• Производительность функции может снизиться при работе с несколькими источниками данных из разных кластеров.

Синтаксис

count_distinct(Expr)

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

Параметры

Имя	Тип	Обязательно	Описание
expr	скаляр	✔️	Выражение, уникальные значения которого подсчитываются.

Возвращаемое значение

Длинное целочисленное значение, указывающее количество уникальных значений expr для сводной группы.

Пример

В этом примере показано, сколько типов событий шторма произошло в каждом состоянии.

Выполнить запрос

StormEvents
| summarize UniqueEvents=count_distinct(EventType) by State
| top 5 by UniqueEvents

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

Состояние	UniqueEvents
Техас	27
Калифорния	26
ПЕНСИЛЬВАНИЯ	25
Грузия	24
СЕВЕРНАЯ КАРОЛИНА	23