range()

Přepněte služby pomocí rozevíracího seznamu Verze . Přečtěte si další informace o navigaci.
Platí pro: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Vygeneruje dynamické pole, které má řadu rovnoměrně rozmístěných hodnot.

Syntaxe

range( start,stop [,krok])

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Typ	Požadováno	Popis
start	skalární	✔️	Hodnota prvního prvku ve výsledném poli.
Stop	skalární	✔️	Maximální hodnota posledního prvku ve výsledném poli, aby poslední hodnota v řadě byla menší nebo rovna hodnotě stop.
krok	skalární		Rozdíl mezi dvěma po sobě jdoucími prvky pole. Výchozí hodnota pro krok je 1 číselná a 1h pro timespan nebo datetime.

Návraty

Dynamické pole, jehož hodnoty jsou: start, start + step, ... až do a včetně zastavení. Pole je zkráceno, pokud je dosaženo maximálního povoleného počtu výsledků.

Poznámka:

Funkce rozsahu podporuje maximálně 1 048 576 (2^20).

Příklady

Následující příklad vrátí matici čísel z jedné na osm s přírůstkem ze tří.

Spuštění dotazu

print r = range(1, 8, 3)

Výstup

r
[1,4,7]

Následující příklad vrátí matici se všemi daty z roku 2007.

Spuštění dotazu

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

Výstup

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

Následující příklad vrátí matici s čísly mezi 1 a třemi.

Spuštění dotazu

print range(1, 3)

Výstup

print_0
[1,2,3]

Následující příklad vrátí rozsah hodin mezi 1 hodinou a pěti hodinami.

Spuštění dotazu

print range(1h, 5h)

Výstup

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

Následující příklad vrátí zkrácenou matici, protože rozsah překračuje limit maximálních výsledků. Příklad ukazuje, že limit je překročen pomocí operátoru mv-expand k rozšíření pole do více záznamů a následné počítání počtu záznamů.

Spuštění dotazu

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

Výstup

Počet
1 048 576