make_list_with_nulls() (агрегатная функция)

Создает dynamic массив всех значений expr в группе, включая значения NULL.

Примечание

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

Синтаксис

make_list_with_nulls(Expr)

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

Параметры

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

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

dynamic Возвращает объект JSON (массив) всех значений expr в группе, включая значения NULL. Если входные данные оператора summarize не отсортированы, порядок элементов в результирующем массиве не определен. Если входные данные оператора summarize отсортированы, порядок элементов в результирующем массиве отслеживает порядок входных данных.

Совет

Используйте функцию array_sort_asc() или array_sort_desc() для создания упорядоченного списка по определенному ключу.

Пример

В следующем примере в результатах показаны значения NULL.

let shapes = datatable (name:string , sideCount: int)
[
    "triangle", int(null),
    "square", 4,
    "rectangle", 4,
    "pentagon", 5,
    "hexagon", 6,
    "heptagon", 7,
    "octagon", 8,
    "nonagon", 9,
    "decagon", 10
];
shapes
| summarize mylist = make_list_with_nulls(sideCount)

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

Mylist
[null,4,4,5,6,7,8,9,10]