operator zakresu

Dotyczy: ✅Microsoft Fabric✅

Generuje jednokolumniową tabelę wartości.

Składnia

range nazwa_from kolumny początektozatrzymaćstepkrok

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

Parametry

Zwraca

Tabela z jedną kolumną o nazwie columnName, której wartości są uruchamiane, , ... do i do +.

Przykłady

W przykładzie w tej sekcji pokazano, jak używać składni, aby ułatwić rozpoczęcie pracy.

Zakres w ciągu ostatnich siedmiu dni

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

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

Wyjście

Łączenie różnych godzin zatrzymania

W poniższym przykładzie pokazano, jak rozszerzyć zakresy na wielokrotne czasy zatrzymania przy użyciu operatora union.

let Range1 = range Time from datetime(2024-01-01) to datetime(2024-01-05) step 1d;
let Range2 = range Time from datetime(2024-01-06) to datetime(2024-01-10) step 1d;
union Range1, Range2
| order by Time asc

Wyjście

Zakres przy użyciu parametrów

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

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

Wyjście

Kroki przyrostowe

W poniższym przykładzie utworzono tabelę z jedną kolumną o nazwie Steps, której typ jest long, a wyniki są tworzone z jednej do ośmiu przyrostów o trzy.

range Steps from 1 to 8 step 3

Wyjście

Ślady w zakresie czasu

W poniższym przykładzie pokazano, jak można użyć operatora range do utworzenia tabeli wymiarów używanej do wprowadzenia zer, w których dane źródłowe nie mają wartości. Trwa to znaczniki czasu z ostatnich czterech godzin i zlicza ślady dla każdego interwału jednej minuty. Jeśli nie ma śladów dla określonego interwału, liczba jest równa zero.

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