共用方式為


range()

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

產生一個動態數位,其中包含一系列的相同間距值。

語法

range(start, stop [, step])

深入瞭解 語法慣例

參數

姓名 類型​​ 必要 描述
start 純量 ✔️ 結果陣列中第一個專案的值。
停止 純量 ✔️ 結果陣列中最後一個專案的最大值,使得數列中的最後一個值小於或等於停止值。
純量 陣列的兩個連續元素之間的差異。 步驟的預設值是1針對 numeric 和 1h for timespandatetime

傳回

動態陣列,其值為:startstart + step、 ...最多和包括停止。 如果達到允許的結果數目上限,則會截斷陣列。

注意

範圍函式最多支援 1,048,576 (2^20) 個結果。

範例

下列範例會傳回從一到八的數字數位數位數組,遞增為三。

print r = range(1, 8, 3)

輸出

r
[1,4,7]

下列範例會傳回陣列,其中包含 2007 年的所有日期。

print r = range(datetime(2007-01-01), datetime(2007-12-31), 1d)

輸出

r
[“2007-01-01T00:00:00.00000000Z”,“2007-01-02T00:00:00.0000000Z”,“2007-01-03T00:00:00.0000000Z”,.....,“2007-12-31T00:00:00.0000000Z”]

下列範例會傳回一到三個之間數字的陣列。

print range(1, 3)

輸出

print_0
[1,2,3]

下列範例會傳回介於1小時到5小時之間的小時範圍。

print range(1h, 5h)

輸出

print_0
1,000,000
["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"]

下列範例會傳回截斷的數位,因為範圍超過最大結果限制。 此範例示範使用 mv-expand 運算子將陣列展開為多個記錄,然後計算記錄數目,來超過限制。

print r = range(1,1000000000) 
| mv-expand r 
| count

輸出

計數
1,048,576