共用方式為

make_list（） （聚合函數）

  • 發行項

適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel

dynamic建立群組中 expr 所有值的陣列。

Null 值會被忽略，且不會納入計算。

注意

此函式會與 summarize 運算子搭配使用。

已被取代的別名： makelist（）

語法

make_list(expr [, maxSize])

深入瞭解 語法慣例。

參數

姓名 類型​​ 必要 描述
expr dynamic ✔️ 用於匯總計算的表達式。
maxSize int 傳回的元素數目上限。 預設值和最大值為 1048576。

注意

已淘汰的版本預設 maxSize 限制為 128。

傳回

傳dynamic回群組中expr所有值的陣列。 如果未排序運算子的 summarize 輸入，則產生的陣列中的元素順序為未定義。 如果運算子的 summarize 輸入已排序，則產生的陣列中的元素順序會追蹤輸入的順序。

提示

使用 或 array_sort_desc() 函array_sort_asc()式，透過某些索引鍵建立已排序的清單。

範例

一欄

下列範例會將清單從單一數據行中取出：

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

輸出

mylist
[“三角形”，“方形”，“矩形”，“五角大樓”，“六邊形”，“heptagon”，“八角”，“非對角”，“decagon”]

使用 'by' 子句

下列範例會使用 by 子句執行查詢：

let shapes = datatable (name: string, sideCount: int)
[
    "triangle", 3,
    "square", 4,
    "rectangle", 4,
    "pentagon", 5,
    "hexagon", 6,
    "heptagon", 7,
    "octagon", 8,
    "nonagon", 9,
    "decagon", 10
];
shapes
| summarize mylist = make_list(name) by isEvenSideCount = sideCount % 2 == 0

輸出

isEvenSideCount mylist
false [“三角形”、“五角大樓”、“heptagon”、“nonagon”]
true [“square”，“rectangle”，“hexagon”，“octagon”，“decagon”]

封裝動態物件

下列範例示範如何在 將動態物件設為清單之前，先將動態物件封裝 在數據行中。

let shapes = datatable (name: string, sideCount: int)
[
    "triangle", 3,
    "square", 4,
    "rectangle", 4,
    "pentagon", 5,
    "hexagon", 6,
    "heptagon", 7,
    "octagon", 8,
    "nonagon", 9,
    "decagon", 10
];
shapes
| extend d = bag_pack("name", name, "sideCount", sideCount)
| summarize mylist = make_list(d) by isEvenSideCount = sideCount % 2 == 0

輸出

isEvenSideCount mylist
false [{“name”：“triangle”，“sideCount”：3}，{“name”：“五角大樓”，“sideCount”：5}，{“name”：“heptagon”，“sideCount”：7}，{“name”：“nonagon”，“sideCount”：9}]
true [{“name”：“square”，“sideCount”：4}，{“name”：“rectangle”，“sideCount”：4}，{“name”：“hexagon”，“sideCount”：6}，{“name”：“octagon”，“sideCount”：8}，{“name”：“decagon”，“sideCount”：10}]

相關內容

make_list_if 運算符類似於 make_list，但也會接受述詞。