operator range

Hiermee wordt een tabel met waarden met één kolom gegenereerd.

Notitie

Deze operator gebruikt geen tabellaire invoer.

Syntax

rangeKolomnaamfromStarttoStoppenstepStap

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
columnName	string	✔️	De naam van de enkele kolom in de uitvoertabel.
start	int, long, real, datetime of time	✔️	De kleinste waarde in de uitvoer.
Stoppen	int, long, real, datetime of time	✔️	De hoogste waarde die wordt gegenereerd in de uitvoer of een afhankelijk van de hoogste waarde als stapstappen over deze waarde worden uitgevoerd.
Stap	int, long, real, datetime of time	✔️	Het verschil tussen twee opeenvolgende waarden.

Notitie

De waarden kunnen niet verwijzen naar de kolommen van een tabel. Als u het bereik wilt berekenen op basis van een invoertabel, gebruikt u de bereikfunctie mogelijk met de operator mv-expand .

Retouren

Een tabel met één kolom met de naam columnName, waarvan de waarden begin, beginstap+, ... tot en totdat u stopt.

Voorbeelden

In het volgende voorbeeld wordt een tabel gemaakt met vermeldingen voor het huidige tijdstempel dat is uitgebreid over de afgelopen zeven dagen, één keer per dag.

De query uitvoeren

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

Uitvoer

Vorige week
2015-12-05 09:10:04.627
2015-12-06 09:10:04.627
...
2015-12-12 09:10:04.627

In het volgende voorbeeld ziet u hoe u de range operator gebruikt met parameters, die vervolgens worden uitgebreid en als een tabel worden gebruikt.

De query uitvoeren

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

Uitvoer

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
...	...	...	...

In het volgende voorbeeld wordt een tabel gemaakt met één kolom met de naam Steps waarvan het type is long en waarvan de waarden , 4en 7zijn1.

De query uitvoeren

range Steps from 1 to 8 step 3

In het volgende voorbeeld ziet u hoe de range operator kan worden gebruikt om een kleine ad-hocdimensietabel te maken die vervolgens wordt gebruikt om nullen te introduceren waarbij de brongegevens geen waarden hebben.

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