assert()

Sürüm açılan listesini kullanarak hizmetler arasında geçiş yapın. Gezinti hakkında daha fazla bilgi edinin.
Şunlar için geçerlidir: ✅ Microsoft Fabric ✅ Azure Veri Gezgini ✅ Azure İzleyici ✅ Microsoft Sentinel

Bir koşulu denetler. Koşul false ise hata iletilerinin çıkışını alır ve sorgu başarısız olur.

Not

İşlev assert , sabit katlama ve koşul kısa devresi gibi iyileştirmeler uygulanmadan önce sorgu analizi aşamasında değerlendirilir.

Not

verilen assert parametrelerin sorgu analizi aşamasında sabitler olarak değerlendirilmesi gerekir. Başka bir deyişle, yalnızca sabitlere başvuran diğer ifadelerden oluşturulabilir ve satır bağlamı ile ilişkili olamaz.

Sözdizimi

assert( koşul,iletisi)

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

Parametreler

Ad	Tür	Zorunlu	Açıklama
koşul	bool	✔️	Değerlendirilecek koşullu ifade. Koşul, sorgu analizi aşamasında sabit olarak değerlendirilmelidir.
ileti	string	✔️	Onaylama işlemi olarak değerlendirilirse falsekullanılan ileti.

Döndürülenler

Koşul ise truedöndürürtrue. Koşul olarak değerlendirilirse anlamsal bir hata oluşturur false.

Örnekler

Aşağıdaki sorgu, giriş dizesi uzunluğunu denetleen bir işlev checkLength() tanımlar ve giriş uzunluğu parametresini doğrulamak için kullanır assert (sıfırdan büyük olup olmadığını denetler).

Sorguyu çalıştırma

let checkLength = (len:long, s:string)
{
    assert(len > 0, "Length must be greater than zero") and
    strlen(s) > len
};
datatable(input:string)
[
    '123',
    '4567'
]
| where checkLength(len=long(-1), input)

Bu sorgu çalıştırılırken hata oluşur: assert() has failed with message: 'Length must be greater than zero'

Geçerli len girişle çalıştırma örneği:

Sorguyu çalıştırma

let checkLength = (len:long, s:string)
{
    assert(len > 0, "Length must be greater than zero") and strlen(s) > len
};
datatable(input:string)
[
    '123',
    '4567'
]
| where checkLength(len=3, input)

Çıktı

input
4567

Aşağıdaki sorgu her zaman başarısız olur ve işleç olduğunda assertwhere b veri döndürmese bile işlevin b değerlendirildiğini gösterirfalse:

let b=false;
print x="Hello"
| where b
| where assert(b, "Assertion failed")