range işleci

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

Not

Bu işleç tablosal giriş almaz.

Syntax

rangeColumnnamefromBaşlatmaktoDurdurmakstepAdım

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

Parametreler

Ad Tür Gerekli Açıklama
columnName string ✔️ Çıkış tablosundaki tek sütunun adı.
Başlatmak int, long, real, datetime veya timespan ✔️ Çıktıdaki en küçük değer.
Durdurmak int, long, real, datetime veya timespan ✔️ Çıktıda oluşturulan en yüksek değer veya bu değerin üzerinde adım atılırsa 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, range işlevini potansiyel olarak mv-expand işleciyle kullanın.

Döndürülenler

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

Örnekler

Aşağıdaki örnek, geçerli zaman damgasının girişleri günde bir kez olmak üzere son yedi gün içinde genişletilmiş bir tablo oluşturur.

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

Çıkış

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.

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

Çıkış

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.

range Steps from 1 to 8 step 3

Aşağıdaki örnek, işlecinin range , kaynak verilerin değer içermeyen sıfırları tanıtmak için kullanılan küçük, geçici bir boyut tablosu oluşturmak için nasıl 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