Let deyimi

Deyimlet, bir ifadeye veya işleve eşit bir değişken adı ayarlamak veya görünümler oluşturmak için kullanılır.

let deyimleri şunlar için kullanışlıdır:

• Karmaşık bir ifadeyi, her birinin bir değişkenle temsil ettiği birden çok bölüme ayırma.
• Okunabilirlik için sorgu gövdesi dışındaki sabitleri tanımlama.
• Bir değişkeni bir kez tanımlama ve sorgu içinde birden çok kez kullanma.

Değişken daha önce iç içe deyimler gibi başka bir değeri temsil ettiyse, en let içteki deyim uygulanır.

Deyimin tek bir sorgudaki let birden çok kullanımını iyileştirmek için bkz . Adlandırılmış ifadeleri kullanan sorguları iyileştirme.

Not

deyimi let , bir adı hesaplamanın değerlendirilen değerine değil hesaplamaya bağlar. Bu davranış, hesaplamanın birden çok kez değerlendirilmesine bağlı olarak aynı ada yapılan birden çok başvurunun farklı değerler döndürebileceği anlamına gelir. İstenen davranış bu değilse toscalar() veya materialize() kullanın.

Sözdizimi: Skaler veya tablosal ifadeler

letAd = İfade

Önemli

Let deyimlerinin ardından noktalı virgül gelmelidir. let deyimleri arasında veya let deyimleri ile diğer sorgu deyimleri arasında boş satır olamaz.

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

Parametreler

Ad	Tür	Zorunlu	Açıklama
Adı	string	✔️	Değişken adı. Adından köşeli ayraçla kaçabilirsiniz. Örneğin, ["Name with spaces"].
Expression	string	✔️	Skaler veya tablosal sonucu olan bir ifade. Örneğin, skaler sonucu let one=1;olan bir ifade olacaktır ve tablosal sonucu olan bir ifade olacaktır let RecentLog = Logs | where Timestamp > ago(1h).

Söz dizimi: Görünüm veya işlev

letAd = [view] ([ Parametreler ] ) { FunctionBody }

Önemli

Let deyimlerinin ardından noktalı virgül gelmelidir. let deyimleri arasında veya let deyimleri ile diğer sorgu deyimleri arasında boş satır olamaz.

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

Parametreler

Ad	Tür	Zorunlu	Açıklama
FunctionBody	string	✔️	Kullanıcı tanımlı bir işlev veren ifade.
view	string		Yalnızca parametresiz let bir deyim için geçerlidir. Kullanıldığında deyimi, let tabloların/görünümlerin joker karakter seçimine sahip bir union işleç içeren sorgulara eklenir. Örnek için bkz . Görünüm veya sanal tablo oluşturma.
Parametreler	string		Sıfır veya daha fazla virgülle ayrılmış tablosal veya skaler işlev parametresi. Tablosal türdeki her parametre için, parametresi TableName:TableSchema biçiminde olmalıdır. Bu durumda TableSchema, ColumnName:ColumnType biçimindeki sütunların virgülle ayrılmış listesi veya joker karakter (* ) şeklindedir. Sütunlar belirtilirse, giriş tablosal bağımsız değişkeni bu sütunları içermelidir. Joker karakter belirtilirse, giriş tablosal bağımsız değişkeni herhangi bir şemaya sahip olabilir. İşlev gövdesindeki sütunlara başvurmak için bunların belirtilmesi gerekir. Örnekler için bkz . Şema içeren Tablosal bağımsız değişken ve joker karakterli Tablosal bağımsız değişken. Skaler türündeki her parametre için, parametre adını ve parametre türünü Ad:Türü biçiminde belirtin. Ad FunctionBody içinde görünebilir ve kullanıcı tanımlı işlev çağrıldığında belirli bir değere bağlıdır. Desteklenen tek türler , , , , , , , , dynamicve bu türlerin diğer adlarıdırbool. realtimespandatetimelongstring

Not

• Tablosal parametreler skaler parametrelerden önce görünmelidir.
• İki deyim noktalı virgülle ayrılmalıdır.

Örnekler

Skaler değerleri tanımlama

Aşağıdaki örnekte skaler ifade deyimi kullanılır.

let n = 10;  // number
let place = "Dallas";  // string
let cutoff = ago(62d); // datetime 
Events 
| where timestamp > cutoff 
    and city == place 
| take n

Aşağıdaki örnek, gösterimi kullanarak ['name'] adı some number bağlar ve ardından tablosal ifade deyiminde kullanır.

Sorguyu çalıştırma

let ['some number'] = 20;
range y from 0 to ['some number'] step 5

Skaler hesaplama ile kullanıcı tanımlı işlev oluşturma

Bu örnek, skaler hesaplama için bağımsız değişkenlerle let deyimini kullanır. Sorgu, iki sayıyı çarpma işlevini MultiplyByN tanımlar.

Sorguyu çalıştırma

let MultiplyByN = (val:long, n:long) { val * n };
range x from 1 to 5 step 1 
| extend result = MultiplyByN(x, 5)

Çıktı

x	result
1	5
2	10
3	15
4	20
5	25

Girişi kırpan kullanıcı tanımlı bir işlev oluşturma

Aşağıdaki örnek, girişten baştaki ve sondakileri kaldırır.

Sorguyu çalıştırma

let TrimOnes = (s:string) { trim("1", s) };
range x from 10 to 15 step 1 
| extend result = TrimOnes(tostring(x))

Çıktı

x	result
10	0
11
12	2
13	3
14	4
15	5

Birden çok let deyimi kullanma

Bu örnek, bir deyimin () başkafoo1 bir deyimi (foo2) kullandığı iki let deyimini tanımlar.

Sorguyu çalıştırma

let foo1 = (_start:long, _end:long, _step:long) { range x from _start to _end step _step};
let foo2 = (_step:long) { foo1(1, 100, _step)};
foo2(2) | count

Çıktı

result
50

Görünüm veya sanal tablo oluşturma

Bu örnekte, bir veya sanal tablo oluşturmak view için let deyiminin nasıl kullanılacağı gösterilmektedir.

Sorguyu çalıştırma

let Range10 = view () { range MyColumn from 1 to 10 step 1 };
let Range20 = view () { range MyColumn from 1 to 20 step 1 };
search MyColumn == 5

Çıktı

$table	MyColumn
Aralık10	5
Aralık20	5

Gerçekleştirme işlevi kullanma

işlevi, materialize() sorgu yürütme sırasında alt sorgu sonuçlarını önbelleğe almanızı sağlar. işlevini kullandığınızda materialize() veriler önbelleğe alınır ve sonucun sonraki çağrıları önbelleğe alınmış verileri kullanır.

let totalPagesPerDay = PageViews
| summarize by Page, Day = startofday(Timestamp)
| summarize count() by Day;
let materializedScope = PageViews
| summarize by Page, Day = startofday(Timestamp);
let cachedResult = materialize(materializedScope);
cachedResult
| project Page, Day1 = Day
| join kind = inner
(
    cachedResult
    | project Page, Day2 = Day
)
on Page
| where Day2 > Day1
| summarize count() by Day1, Day2
| join kind = inner
    totalPagesPerDay
on $left.Day1 == $right.Day
| project Day1, Day2, Percentage = count_*100.0/count_1

Çıktı

Gün1	Gün2	Yüzde
2016-05-01 00:00:00.0000000	2016-05-02 00:00:00.0000000	34.0645725975255
2016-05-01 00:00:00.0000000	2016-05-03 00:00:00.0000000	16.618368960101
2016-05-02 00:00:00.0000000	2016-05-03 00:00:00.0000000	14.6291376489636

İç içe let deyimlerini kullanma

İç içe let deyimlerine, kullanıcı tanımlı işlev ifadesi içinde de dahil olmak üzere izin verilir. deyimlerinin ve bağımsız değişkenlerin işlev gövdesinin hem geçerli hem de iç kapsamına uygulanmasına izin verin.

let start_time = ago(5h); 
let end_time = start_time + 2h; 
T | where Time > start_time and Time < end_time | ...

Şema ile tablosal bağımsız değişken

Aşağıdaki örnek, tablo parametresinin T türünde stringbir sütunu State olması gerektiğini belirtir. Tablo T başka sütunlar da içerebilir, ancak bunlar bildirilemediğinden işlevde StateState bunlara başvurulamazsınız.

Sorguyu çalıştırma

let StateState=(T: (State: string)) { T | extend s_s=strcat(State, State) };
StormEvents
| invoke StateState()
| project State, s_s

Çıktı

Durum	s_s
ATLANTIK GÜNEY	ATLANTIC SOUTHATLANTIC SOUTH
FLORIDA	FLORIDAFLORIDA
FLORIDA	FLORIDAFLORIDA
GEORGIA	GEORGIAGEORGIA
MISSISSIPPI	MISSISSIPPIMISSISSIPPI
...	...

Joker karakterli tablosal bağımsız değişken

Tablo parametresi T herhangi bir şemaya sahip olabilir ve işlev CountRecordsInTable çalışır.

Sorguyu çalıştırma

let CountRecordsInTable=(T: (*)) { T | count };
StormEvents | invoke CountRecordsInTable()

Çıktı

Sayı
59,066