Freigeben über

range()

  • Artikel

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Generiert ein dynamisches Array mit einer Reihe gleichmäßig verteilter Werte.

Syntax

range(Startstopp, [, Schritt])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
start Skalarwert ✔️ Der Wert des ersten Elements im resultierenden Array.
stop Skalarwert ✔️ Der Maximalwert des letzten Elements im resultierenden Array, sodass der letzte Wert in der Datenreihe kleiner oder gleich dem Stoppwert ist.
Schritt Skalar Der Unterschied zwischen zwei aufeinander folgenden Elementen des Arrays. Der Standardwert für Schritt ist für numerisch und 1h für timespan oder datetime.1

Gibt zurück

Ein dynamisches Array, dessen Werte sind: Start, Startschritt + , ... bis zu und einschließlich Stopp. Das Array wird abgeschnitten, wenn die maximale Anzahl zulässiger Ergebnisse erreicht ist.

Hinweis

Die Bereichsfunktion unterstützt maximal 1.048.576 (2^20) Ergebnisse.

Beispiele

Das folgende Beispiel gibt ein Array von Zahlen von 1 bis acht zurück, wobei ein Inkrement von drei erhöht wird.

print r = range(1, 8, 3)

Output

r
[1,4,7]

Im folgenden Beispiel wird ein Array mit allen Datumsangaben aus dem Jahr 2007 zurückgegeben.

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

Output

r
["2007-01-01T00:00:00.000000Z","2007-01-02T00:00:00.0000000Z","2007-01-03T00:00:00.000000Z",.....,"2007-12-31T00:00:00.0000000Z"]

Im folgenden Beispiel wird ein Array mit Zahlen zwischen 1 und drei zurückgegeben.

print range(1, 3)

Output

print_0
[1,2,3]

Im folgenden Beispiel wird ein Stundenbereich zwischen einer Stunde und fünf Stunden zurückgegeben.

print range(1h, 5h)

Output

print_0
1\.000.000
["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"]:

Im folgenden Beispiel wird ein abgeschnittenes Array zurückgegeben, da der Bereich die maximale Ergebnisgrenze überschreitet. Das Beispiel zeigt, dass der Grenzwert überschritten wird, indem der mv-expand-Operator verwendet wird, um das Array in mehrere Datensätze zu erweitern und dann die Anzahl der Datensätze zu zählen.

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

Output

Anzahl
1.048.576