tartomány operátora

A következőkre vonatkozik: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Egyoszlopos értéktáblázatot hoz létre.

Szintaxis

range columnNamefromstarttostopstepstep

További információ szintaxiskonvenciákról.

Paraméterek

Visszatér

Egy oszlopNévnevű egyetlen oszlopot tartalmazó táblázat, amelynek értékei kezdődnek, +lépés, ... leállításáig.

Példák

Az ebben a szakaszban szereplő példa bemutatja, hogyan használható a szintaxis az első lépésekhez.

Tartomány az elmúlt hét napban

Az alábbi példa egy táblázatot hoz létre, amely az elmúlt hét napban meghosszabbított aktuális időbélyeg bejegyzéseit tartalmazza, naponta egyszer.

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

kimeneti

Különböző leállítási időpontok egyesítése

Az alábbi példa bemutatja, hogyan hosszabbíthat tartományokat több leállítási időpontra a union operátor használatával.

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

kimeneti

Tartomány paraméterekkel

Az alábbi példa bemutatja, hogyan használhatja a range operátort paraméterekkel, amelyeket aztán kiterjesztünk és táblázatként használunk fel.

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

kimeneti

Növekményes lépések

Az alábbi példa egy Steps nevű egyetlen oszlopot tartalmazó táblát hoz létre, amelynek típusa long, és egytől nyolcig terjedő értékeket eredményez hárommal növelve.

range Steps from 1 to 8 step 3

kimeneti

Nyomkövetések egy időtartományban

Az alábbi példa bemutatja, hogyan használható a range operátor olyan dimenziótáblák létrehozására, amelyek nullák bevezetésére szolgálnak, ahol a forrásadatok nem tartalmaznak értékeket. Az elmúlt négy óra időbélyegeit veszi figyelembe, és minden egyes egyperces időközhöz megszámlálja a nyomkövetést. Ha egy adott intervallumhoz nincs nyomkövetés, a szám nulla.

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