in operator

Hiermee filtert u een recordset voor gegevens met een hoofdlettergevoelige tekenreeks.

De volgende tabel bevat een vergelijking van de in operators:

Operator	Beschrijving	Case-Sensitive	Voorbeeld (opbrengsten true)
in	Is gelijk aan een van de elementen	Yes	"abc" in ("123", "345", "abc")
!in	Is niet gelijk aan een van de elementen	Yes	"bca" !in ("123", "345", "abc")
in~	Is gelijk aan een van de elementen	No	"Abc" in~ ("123", "345", "abc")
!in~	Is niet gelijk aan een van de elementen	No	"bCa" !in~ ("123", "345", "ABC")

Notitie

Geneste matrices worden afgevlakt in één lijst met waarden. x in (dynamic([1,[2,3]])) wordt bijvoorbeeld x in (1,2,3).

Zie Tekenreeksoperators voor gegevenstypen voor meer informatie over andere operators en om te bepalen welke operator het meest geschikt is voor uw query.

Niet-hoofdlettergevoelige operators worden momenteel alleen ondersteund voor ASCII-tekst. Gebruik de functie tolower() voor niet-ASCII-vergelijking.

Tips voor prestaties

Notitie

De prestaties zijn afhankelijk van het type zoekopdracht en de structuur van de gegevens. Zie Best practices voor query's voor aanbevolen procedures.

Syntax

T|whereKolonelin(Expressie, ... )

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
T	string	✔️	De tabellaire invoer om te filteren.
Kolonel	string	✔️	De kolom waarop u wilt filteren.
expression	scalair of tabellair	✔️	Een expressie die de waarden aangeeft waarnaar moet worden gezocht. de waarden waarnaar moet worden gezocht. Elke expressie kan een scalaire waarde of een tabellaire expressie zijn die een set waarden produceert. Als een tabellaire expressie meerdere kolommen heeft, wordt de eerste kolom gebruikt. De zoekopdracht houdt rekening met maximaal 1.000.000 afzonderlijke waarden.

Notitie

Een inline-tabellaire expressie moet tussen dubbele haakjes worden geplaatst. Zie voorbeeld.

Retouren

Rijen in T waarvan het predicaat is true.

Voorbeelden

Lijst met scalaire waarden

De volgende query laat zien hoe u kunt gebruiken in met een lijst met scalaire waarden.

De query uitvoeren

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

Uitvoer

Count
4775

Dynamische matrix

De volgende query laat zien hoe u kunt gebruiken in met een dynamische matrix.

De query uitvoeren

let states = dynamic(['FLORIDA', 'ATLANTIC SOUTH', 'GEORGIA']);
StormEvents 
| where State in (states)
| count

Uitvoer

Count
3218

Tabellaire expressie

De volgende query laat zien hoe u deze kunt gebruiken in met een tabellaire expressie.

De query uitvoeren

let Top_5_States = 
    StormEvents
    | summarize count() by State
    | top 5 by count_; 
StormEvents 
| where State in (Top_5_States) 
| count

Dezelfde query kan worden geschreven met een inline tabellaire expressie-instructie.

De query uitvoeren

StormEvents 
| where State in (
    StormEvents
    | summarize count() by State
    | top 5 by count_
    ) 
| count

Uitvoer

Count
14242

Bovenaan met een ander voorbeeld

De query uitvoeren

let Lightning_By_State = materialize(StormEvents
    | summarize lightning_events = countif(EventType == 'Lightning') by State);
let Top_5_States = Lightning_By_State | top 5 by lightning_events | project State; 
Lightning_By_State
| extend State = iff(State in (Top_5_States), State, "Other")
| summarize sum(lightning_events) by State 

Uitvoer

Staat	sum_lightning_events
ALABAMA	29
WISCONSIN	31
TEXAS	55
FLORIDA	85
GEORGIË	106
Anders	415

Een statische lijst gebruiken die wordt geretourneerd door een functie

De query uitvoeren

StormEvents 
| where State in (InterestingStates()) 
| count

Uitvoer

Count
4775

De functiedefinitie.

De query uitvoeren

.show function InterestingStates

Uitvoer

Name	Parameters	Hoofdtekst	Map	DocString
InterestingStates	()	{ dynamic(["WASHINGTON", "FLORIDA", "GEORGIA", "NEW YORK"]) }