Başvuru belgeleri için söz dizimi kuralları

  • Makale

Bu makalede, Kusto Sorgu Dili (KQL) ve yönetim komutları başvuru belgelerinde izlenen söz dizimi kuralları özetlenmektedir.

Söz dizimi kuralları

Kural Description
Block Tam olarak gösterildiği gibi girilecek dize değişmez değerleri.
İtalik İşlev veya komut kullanıldığında bir değer sağlanacak parametreler.
[ ] Kapalı öğenin isteğe bağlı olduğunu belirtir.
( ) Kapalı öğelerden en az birinin gerekli olduğunu belirtir.
| (boru) Kanal karakteriyle ayrılmış öğelerden birini belirtebileceğini belirtmek için köşeli ayraçlar içinde kullanılır. Bu formda, boru mantıksal OR işlecine eşdeğerdir. Bir bloğun ()| içinde olduğunda kanal, KQL sorgu söz diziminin bir parçasıdır.
[, ...] Yukarıdaki parametrenin virgülle ayrılmış olarak birden çok kez tekrar edilebileceğini gösterir.
; Sorgu deyimi sonlandırıcısı.

Örnekler

Skaler işlev

Bu örnek, söz dizimini ve karma işlevinin örnek kullanımını ve ardından her söz dizimi bileşeninin örnek kullanıma nasıl çevrildiğiyle ilgili bir açıklamayı gösterir.

Syntax

hash(kaynak [,mod])

Örnek kullanım

hash("World")
  • işlevinin hashadı ve açılış parantezi tam olarak gösterildiği gibi girilir.
  • "World", gerekli kaynak parametresi için bağımsız değişken olarak geçirilir.
  • Mod parametresi için, köşeli ayraçlar tarafından gösterildiği gibi isteğe bağlı olan hiçbir bağımsız değişken geçirilmemektedir.
  • Kapanış parantezi tam olarak gösterildiği gibi girilir.

Tablo işleci

Bu örnek, söz dizimini ve sıralama işlecinin örnek kullanımını ve ardından her söz dizimi bileşeninin örnek kullanıma nasıl çevrildiğiyle ilgili bir açıklamayı gösterir.

Syntax

T| sort bysütun [asc | desc] [nulls first | nulls last] [, ...]

Örnek kullanım

StormEvents
| sort by State asc, StartTime desc
  • StormEvents tablosu, gerekli T parametresi için bağımsız değişken olarak geçirilir.
  • | sort by tam olarak gösterildiği gibi girilir. Bu durumda, kanal karakteri, blok metniyle gösterildiği gibi tablosal ifade deyimi söz diziminin bir parçasıdır. Daha fazla bilgi edinmek için bkz. Sorgu deyimi nedir?
  • State sütunu, isteğe bağlı asc bayrağıyla gerekli sütun parametresi için bağımsız değişken olarak geçirilir.
  • Virgülden sonra başka bir bağımsız değişken kümesi geçirilir: isteğe bağlı desc bayrağı olan StartTime sütunu. [, ...] söz dizimi daha fazla bağımsız değişken kümesinin geçirilebileceğini ancak gerekli olmadığını gösterir.

İsteğe bağlı parametrelerle çalışma

Başka bir isteğe bağlı parametreden sonra gelen isteğe bağlı bir parametre için bağımsız değişken sağlamak için, önceki parametre için bir bağımsız değişken sağlamanız gerekir. Bu gereksinim, bağımsız değişkenlerin söz diziminde belirtilen sıraya uyması gerektiğidir. parametresi için geçirecek belirli bir değeriniz yoksa, aynı türde boş bir değer kullanın.

Sıralı isteğe bağlı parametreler örneği

http_request eklentisinin söz dizimini göz önünde bulundurun:

evaluatehttp_request(Uri [,RequestHeaders [,Seçenekler]] )

RequestHeaders ve Options, dinamik türünde isteğe bağlı parametrelerdir. Options parametresi için bir bağımsız değişken sağlamak için RequestHeaders parametresi için de bir bağımsız değişken sağlamanız gerekir. Aşağıdaki örnekte, isteğe bağlı ikinci parametre olan Options için bir değer belirtebilmek için isteğe bağlı ilk parametre olan RequestHeaders için nasıl boş bir değer sağlanacak gösterilmektedir.

evaluate http_request ( "https://contoso.com/", dynamic({}), dynamic({ EmployeeName: Nicole }) )

İlgili içerik