Udostępnij za pośrednictwem

range()

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Generuje tablicę dynamiczną zawierającą serię wartości o równym odstępie.

Składnia

range(start, stop [, krok])

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
start skalar ✔️ Wartość pierwszego elementu w wynikowej tablicy.
zatrzymać skalar ✔️ Maksymalna wartość ostatniego elementu w wynikowej tablicy, tak aby ostatnia wartość w serii jest mniejsza lub równa wartości zatrzymania.
krok skalar Różnica między dwoma kolejnymi elementami tablicy. Wartością domyślną kroku jest 1 wartość liczbowa i 1h dla timespan elementu lub datetime.

Zwraca

Tablica dynamiczna, której wartości to: start, start + step, ... do i włącznie z zatrzymaniem. Tablica zostanie obcięta, jeśli zostanie osiągnięta maksymalna dozwolona liczba wyników.

Uwaga

Funkcja range obsługuje maksymalnie 1048 576 (2^20) wyników.

Przykłady

Poniższy przykład zwraca tablicę liczb z jednej do ośmiu z przyrostem trzech.

print r = range(1, 8, 3)

Wyjście

r
[1,4,7]

Poniższy przykład zwraca tablicę ze wszystkimi datami z roku 2007.

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

Wyjście

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

Poniższy przykład zwraca tablicę z liczbami z zakresu od jednego do trzech.

print range(1, 3)

Wyjście

print_0
[1,2,3]

Poniższy przykład zwraca zakres godzin między jedną godziną a pięcioma godzinami.

print range(1h, 5h)

Wyjście

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

Poniższy przykład zwraca obcinaną tablicę, ponieważ zakres przekracza maksymalny limit wyników. W przykładzie pokazano, że limit został przekroczony za pomocą operatora mv-expand , aby rozwinąć tablicę w wielu rekordach, a następnie zliczać liczbę rekordów.

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

Wyjście

Count
1 048 576