in~ operátor

Egy rekordhalmazt szűr egy kis- és nagybetűket nem megkülönböztető sztringgel.

Az alábbi táblázat az operátorok összehasonlítását in tartalmazza:

Operátor	Leírás	Case-Sensitive	Példa (hozamok true)
in	Egyenlő az elemek egyikével	Yes	"abc" in ("123", "345", "abc")
!in	Nem egyenlő egyetlen elemével sem	Yes	"bca" !in ("123", "345", "abc")
in~	Az elemek bármelyikével egyenlő	No	"Abc" in~ ("123", "345", "abc")
!in~	Nem egyenlő egyetlen elemével sem	No	"bCa" !in~ ("123", "345", "ABC")

Megjegyzés

A beágyazott tömbök egyetlen értéklistába vannak osztva. Például a következő leszx in (1,2,3): x in (dynamic([1,[2,3]])) .

A többi operátorral kapcsolatos további információkért és annak meghatározásához, hogy melyik operátor felel meg a lekérdezésnek, tekintse meg az adattípus-sztringoperátorok című témakört.

A kis- és nagybetűket nem megkülönböztető operátorok jelenleg csak ASCII-szöveg esetén támogatottak. Nem ASCII összehasonlításhoz használja a tolower() függvényt.

Teljesítménnyel kapcsolatos tippek

Megjegyzés

A teljesítmény a keresés típusától és az adatok szerkezetétől függ. Az ajánlott eljárásokért lásd: Ajánlott eljárások lekérdezése.

Ha lehetséges, használja a kis- és nagybetűk megkülönböztetése lehetőséget.

Syntax

T|whereColin~(Kifejezés, ... )

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

Paraméterek

Név	Típus	Kötelező	Leírás
T	string	✔️	A szűrni kívánt táblázatos bemenet.
Col	string	✔️	Az oszlop, amely alapján szűrni szeretne.
expression	skaláris vagy táblázatos	✔️	Egy kifejezés, amely meghatározza azokat az értékeket, amelyekre keresni szeretne. Minden kifejezés lehet skaláris érték vagy táblázatos kifejezés , amely értékkészletet hoz létre. Ha egy táblázatos kifejezés több oszlopot tartalmaz, a rendszer az első oszlopot használja. A keresés legfeljebb 1 000 000 különböző értéket vesz figyelembe.

Válaszok

A T azon sorai, amelyek predikátuma true.

Példák

Skalárisok listája

Az alábbi lekérdezés bemutatja, hogyan használható in~ a skaláris értékek vesszővel tagolt listájával.

A lekérdezés futtatása

StormEvents 
| where State in~ ("FLORIDA", "georgia", "NEW YORK") 
| count

Kimenet

Darabszám
4775

Dinamikus tömb

Az alábbi lekérdezés bemutatja, hogyan használható in~ dinamikus tömbbel.

A lekérdezés futtatása

StormEvents 
| where State in~ (dynamic(["FLORIDA", "georgia", "NEW YORK"])) 
| count

Kimenet

Darabszám
4775

Ugyanez a lekérdezés let utasítással is megírható.

A lekérdezés futtatása

let states = dynamic(["FLORIDA", "georgia", "NEW YORK"]);
StormEvents 
| where State has_any (states)
| summarize count() by State

Kimenet

Darabszám
4775

Táblázatos kifejezés

Az alábbi lekérdezés bemutatja, hogyan használható in~ beágyazott táblázatos kifejezésekkel. Figyelje meg, hogy egy beágyazott táblázatos kifejezést dupla zárójelek közé kell tenni.

A lekérdezés futtatása

StormEvents 
| where State in~ (PopulationData | where Population > 5000000 | project State)
| summarize count() by State

Kimenet

Állapot	Számít_
TEXAS	4701
ILLINOIS	2022
MISSOURI	2016
GRÚZIA	1983
MINNESOTA	1881
...	...

Ugyanez a lekérdezés let utasítással is megírható. Figyelje meg, hogy ebben az esetben nincs szükség az előző példában megadott dupla zárójelekre.

A lekérdezés futtatása

let large_states = PopulationData | where Population > 5000000 | project State;
StormEvents 
| where State in~ (large_states)
| summarize count() by State

Kimenet

Állapot	Számít_
TEXAS	4701
ILLINOIS	2022
MISSOURI	2016
GRÚZIA	1983
MINNESOTA	1881
...	...