Share via


make_list_with_nulls() (função de agregação)

Cria uma dynamic matriz de todos os valores de expr no grupo, incluindo valores nulos.

Nota

Esta função é utilizada em conjunto com o operador de resumo.

Syntax

make_list_with_nulls(expr)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
expr string ✔️ A expressão que deve utilizar para criar a matriz.

Devoluções

Devolve um dynamic objeto JSON (matriz) de todos os valores de expr no grupo, incluindo valores nulos. Se a entrada do summarize operador não estiver ordenada, a ordem dos elementos na matriz resultante é indefinida. Se a entrada do summarize operador estiver ordenada, a ordem dos elementos na matriz resultante controla a entrada.

Dica

Utilize a array_sort_asc() função ou array_sort_desc() para criar uma lista ordenada por alguma chave.

Exemplo

O exemplo seguinte mostra valores nulos nos resultados.

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)

Saída

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