operator in~

Hiermee filtert u een recordset op gegevens met een tekenreeks die niet hoofdlettergevoelig is.

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.

Gebruik indien mogelijk hoofdlettergevoelig in.

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. 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.

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 door komma's gescheiden 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

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

Uitvoer

Count
4775

Dezelfde query kan ook worden geschreven met een let-instructie.

De query uitvoeren

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

Uitvoer

Count
4775

Tabellaire expressie

De volgende query laat zien hoe u kunt gebruiken in~ met een inline-expressie in tabelvorm. U ziet dat een inline-expressie in tabelvorm tussen dubbele haakjes moet worden geplaatst.

De query uitvoeren

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

Uitvoer

Staat	Tellen_
TEXAS	4701
ILLINOIS	2022
MISSOURI	2016
GEORGIË	1983
MINNESOTA	1881
...	...

Dezelfde query kan ook worden geschreven met een let-instructie. U ziet dat de dubbele haakjes zoals opgegeven in het laatste voorbeeld in dit geval niet nodig zijn.

De query uitvoeren

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

Uitvoer

Staat	Tellen_
TEXAS	4701
ILLINOIS	2022
MISSOURI	2016
GEORGIË	1983
MINNESOTA	1881
...	...