in~ 연산자

대/소문자를 구분하지 않는 문자열을 사용하여 데이터에 대한 레코드 집합을 필터링합니다.

다음 표에서는 연산자를 비교합니다 in .

연산자	설명	대/소문자 구분	예제(true 생성)
in	요소 중 하나와 같음	예	"abc" in ("123", "345", "abc")
!in	어떤 요소와도 같지 않음	예	"bca" !in ("123", "345", "abc")
in~	모든 요소와 같음	아니요	"Abc" in~ ("123", "345", "abc")
!in~	어떤 요소와도 같지 않음	No	"bCa" !in~ ("123", "345", "ABC")

참고

중첩된 배열은 값의 단일 목록으로 병합됩니다. 예를 들어 x in (dynamic([1,[2,3]]))는 x in (1,2,3)가 됩니다.

다른 연산자에 대한 자세한 내용과 쿼리에 가장 적합한 연산자를 확인하려면 데이터 형식 문자열 연산자를 참조하세요.

대/소문자를 구분하지 않는 연산자는 현재 ASCII 텍스트에 대해서만 지원됩니다. 비 ASCII 비교의 경우 tolower() 함수를 사용합니다.

성능 팁

참고

성능은 검색 유형 및 데이터 구조에 따라 달라집니다. 모범 사례는 쿼리 모범 사례를 참조하세요.

가능하면 대/소문자를 구분하여 를 사용합니다.

Syntax

T|whereColin~(식, ... )

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름	형식	필수	설명
T	string	✔️	필터링할 테이블 형식 입력입니다.
col	string	✔️	필터링할 열입니다.
expression	스칼라 또는 테이블 형식	✔️	검색할 값을 지정하는 식입니다. 각 식은 스칼라 값 또는 값 집합을 생성하는 테이블 형식 식 일 수 있습니다. 테이블 형식 식에 여러 열이 있는 경우 첫 번째 열이 사용됩니다. 검색은 최대 1,000,000개의 고유 값을 고려합니다.

반환

조건자가 true인 T의 행입니다.

예제

스칼라 목록

다음 쿼리는 스칼라 값의 쉼표로 구분된 목록과 함께 사용하는 in~ 방법을 보여 있습니다.

쿼리 실행

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

출력

개수
4775

동적 배열

다음 쿼리는 동적 배열과 함께 사용하는 in~ 방법을 보여줍니다.

쿼리 실행

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

출력

개수
4775

let 문을 사용하여 동일한 쿼리를 작성할 수도 있습니다.

쿼리 실행

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

출력

개수
4775

테이블 형식 식

다음 쿼리는 인라인 테이블 형식 식과 함께 사용하는 in~ 방법을 보여줍니다. 인라인 테이블 형식 식은 이중 괄호로 묶어야 합니다.

쿼리 실행

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

출력

시스템 상태	count_
텍사스	4701
일리노이	2022
미주리	2016
GEORGIA	1983
미네소타	1881
...	...

let 문을 사용하여 동일한 쿼리를 작성할 수도 있습니다. 이 경우 마지막 예제에 제공된 이중 괄호가 필요하지 않습니다.

쿼리 실행

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

출력

시스템 상태	count_
텍사스	4701
일리노이	2022
미주리	2016
GEORGIA	1983
미네소타	1881
...	...