range işleci

Tek sütunlu bir değer tablosu oluşturur.

Not

Bu işleç tablosal giriş almaz.

Sözdizimi

rangecolumnName from başlamak to durmak step adım

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad	Tür	Zorunlu	Açıklama
columnName	string	✔️	Çıkış tablosundaki tek sütunun adı.
start	int, long, real, datetime veya timespan	✔️	Çıktıdaki en küçük değer.
durmak	int, long, real, datetime veya timespan	✔️	Çıktıda oluşturulan en yüksek değer veya bu değerin üzerinde adım atılması durumunda en yüksek değere bağlı.
adım	int, long, real, datetime veya timespan	✔️	Ardışık iki değer arasındaki fark.

Not

Değerler herhangi bir tablonun sütunlarına başvuramaz. Aralığı bir giriş tablosuna göre hesaplamak istiyorsanız, potansiyel olarak mv-expand işleciyle aralık işlevini kullanın.

Döndürülenler

Değerleri start, start + step, ... olan columnName adlı tek sütunlu bir tablo. kadar ve durana kadar.

Örnekler

Aşağıdaki örnek, geçerli zaman damgasının girdilerinin günde bir kez olmak üzere son yedi gün içinde uzatılmış olduğu bir tablo oluşturur.

Sorguyu çalıştırma

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

Çıktı

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

Aşağıdaki örnekte, işlecinin range daha sonra genişletilmiş ve tablo olarak kullanılan parametrelerle nasıl kullanılacağı gösterilmektedir.

Sorguyu çalıştırma

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

Çıktı

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

Aşağıdaki örnek, türü long ve değerleri 1, 4ve 7olan adlı Steps tek bir sütuna sahip bir tablo oluşturur.

Sorguyu çalıştırma

range Steps from 1 to 8 step 3

Aşağıdaki örnekte, işlecin kaynak verilerin hiçbir değeri olmayan sıfırları tanıtmak için kullanılan küçük, geçici bir boyut tablosu oluşturmak için nasıl range kullanılabileceğini gösterir.

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