operator zakresu

Generuje jednokolumniową tabelę wartości.

Uwaga

Ten operator nie pobiera danych wejściowych tabelarycznych.

Składnia

rangeColumnnamefromUruchomićtoZatrzymaćstepKrok

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa	Typ	Wymagane	Opis
columnName	string	✔️	Nazwa pojedynczej kolumny w tabeli wyjściowej.
Uruchomić	int, long, real, datetime lub timespan	✔️	Najmniejsza wartość w danych wyjściowych.
Zatrzymać	int, long, real, datetime lub timespan	✔️	Najwyższa wartość generowana w danych wyjściowych lub powiązana z najwyższą wartością, jeśli krok zostanie opisany w tej wartości.
Krok	int, long, real, datetime lub timespan	✔️	Różnica między dwiema kolejnymi wartościami.

Uwaga

Wartości nie mogą odwoływać się do kolumn żadnej tabeli. Jeśli chcesz obliczyć zakres na podstawie tabeli wejściowej, użyj funkcji zakresu potencjalnie z operatorem mv-expand .

Zwraca

Tabela z jedną kolumną o nazwie columnName, której wartości są początkowe, krok początkowy+, ... do i do momentu zatrzymania.

Przykłady

Poniższy przykład tworzy tabelę z wpisami dla bieżącej sygnatury czasowej rozszerzonej w ciągu ostatnich siedmiu dni, raz dziennie.

Uruchamianie zapytania

range LastWeek from ago(7d) to now() step 1d

Dane wyjściowe

Ostatniweek
2015-12-05 09:10:04.627
2015-12-06 09:10:04.627
...
2015-12-12 09:10:04.627

W poniższym przykładzie pokazano, jak używać range operatora z parametrami, które następnie są rozszerzone i używane jako tabela.

Uruchamianie zapytania

let toUnixTime = (dt:datetime) 
{ 
    (dt - datetime(1970-01-01)) / 1s 
};
let MyMonthStart = startofmonth(now()); //Start of month
let StepBy = 4.534h; //Supported timespans
let nn = 64000; // Row Count parametrized
let MyTimeline = range MyMonthHour from MyMonthStart to now() step StepBy
| extend MyMonthHourinUnixTime = toUnixTime(MyMonthHour), DateOnly = bin(MyMonthHour,1d), TimeOnly = MyMonthHour - bin(MyMonthHour,1d)
; MyTimeline | order by MyMonthHour asc | take nn

Dane wyjściowe

MyMonthHour	MyMonthHourinUnixTime	DateOnly	TimeOnly
2023-02-01	00:00:00.0000000	1675209600	2023-02-01 00:00:00.0000000
2023-02-01	04:32:02.4000000	1675225922.4	2023-02-01 00:00:00.0000000
2023-02-01	09:04:04.8000000	1675242244.8	2023-02-01 00:00:00.0000000
2023-02-01	13:36:07.2000000	1675258567.2	2023-02-01 00:00:00.0000000
...	...	...	...

Poniższy przykład tworzy tabelę z jedną kolumną o nazwie Steps , której typem jest long i których wartościami są 1, 4i 7.

Uruchamianie zapytania

range Steps from 1 to 8 step 3

W poniższym przykładzie pokazano, jak range można użyć operatora do utworzenia małej, ad hoc tabeli wymiarów, która jest następnie używana do wprowadzania zer, w których dane źródłowe nie mają wartości.

range TIMESTAMP from ago(4h) to now() step 1m
| join kind=fullouter
  (Traces
      | where TIMESTAMP > ago(4h)
      | summarize Count=count() by bin(TIMESTAMP, 1m)
  ) on TIMESTAMP
| project Count=iff(isnull(Count), 0, Count), TIMESTAMP
| render timechart