Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |