where operátor

A táblázatot a predikátumnak megfelelő sorok részhalmazára szűri.

A where és filter operátorok egyenértékűek

Syntax

T| wherePredikátum

További információ a szintaxis konvenciókról.

Paraméterek

Név Típus Kötelező Leírás
T string ✔️ Táblázatos bemenet, amelynek rekordjait szűrni kell.
Predikátum string ✔️ Kifejezés, amely a T minden sorához egy bool értéket ad vissza.

Válaszok

A T azon sorai, amelyek predikátuma .true

Megjegyzés

Minden szűrőfüggvény hamis értéket ad vissza null értékekkel összehasonlítva. A null értékeket kezelő lekérdezések írásához használjon speciális nullérzékeny függvényeket.

Teljesítménnyel kapcsolatos tippek

  • Használjon egyszerű összehasonlításokat az oszlopnevek és az állandók között. (A "Konstans" azt jelenti, hogy állandó a táblán – tehát now() és ago() rendben vannak, és a skaláris értékek is utasítássallet vannak hozzárendelve.)

    Tegyük fel például, hogy inkább a következőt szeretné where Timestamp >= ago(1d) : where bin(Timestamp, 1d) == ago(1d).

  • Elsőként a legegyszerűbb kifejezések: Ha több záradékot andis tartalmaz, először azokat a záradékokat helyezze el, amelyek csak egy oszlopot foglalnak magukban. Így Timestamp > ago(1d) and OpId == EventId jobb, mint fordítva.

További információkért tekintse meg az elérhető sztringoperátorok összegzését és az elérhető numerikus operátorok összegzését.

Példák

Rendelések összehasonlítása összetettség szerint

A következő lekérdezés olyan viharrekordokat ad vissza, amelyek sérült tulajdonságot jelentenek, árvíznek minősülnek, és különböző helyeken kezdődnek és végződnek.

Figyelje meg, hogy a két oszlop összehasonlítását utolsóként állítjuk be, mivel a where operátor nem tudja használni az indexet, és vizsgálatot kényszerít ki.

StormEvents
| project DamageProperty, EventType, BeginLocation, EndLocation
| where DamageProperty > 0
    and EventType == "Flood"
    and BeginLocation != EndLocation 

Az alábbi táblázat csak az első 10 találatot jeleníti meg. A teljes kimenet megtekintéséhez futtassa a lekérdezést.

DamageProperty EventType BeginLocation EndLocation
5000 Árvíz FAYETTE CITY LOWBER
5000 Árvíz MORRISVILLE WEST WAYNESBURG
10000 Árvíz COPELAND HARRIS GROVE
5000 Árvíz GLENFORD MT PERRY
25000 Árvíz KELET-SENECA BUFFALO AIRPARK ARPT
20000 Árvíz EBENEZER SLOAN
10000 Árvíz BUEL CALHOUN
10000 Árvíz GOODHOPE WEST MILFORD
5000 Árvíz DUNKIRK-ERDŐ
20000 Árvíz FARMINGTON MANNINGTON

Annak ellenőrzése, hogy az oszlop tartalmaz-e sztringet

A következő lekérdezés azokat a sorokat adja vissza, amelyekben a "tehén" szó bármely oszlopban megjelenik.

StormEvents
| where * has "cow"