in 演算子

大文字と小文字を区別する文字列を使用して、データのレコード セットをフィルター処理します。

次の表は、in 演算子の比較を示しています。

演算子	説明	大文字と小文字の区別	例 (true になる)
in	要素のいずれかに等しい	はい	"abc" in ("123", "345", "abc")
!in	要素のいずれとも等しくない	はい	"bca" !in ("123", "345", "abc")
in~	要素のいずれかに等しい	いいえ	"Abc" in~ ("123", "345", "abc")
!in~	要素のいずれとも等しくない	いいえ	"bCa" !in~ ("123", "345", "ABC")

Note

入れ子になった配列は、単一の値リストにフラット化されます。 たとえば、x in (dynamic([1,[2,3]])) を x in (1,2,3) にします。

他の演算子の詳細と、クエリに最も適した演算子を確認するには、データ型文字列演算子に関するページを参照してください。

大文字と小文字を区別しない演算子は、現在 ASCII テキストでのみサポートされています。 ASCII 以外の比較には、tolower() 関数を使用してください。

パフォーマンスに関するヒント

Note

パフォーマンスは、検索の種類とデータの構造によって異なります。 ベスト プラクティスについては、「クエリのベスト プラクティス」を参照してください。

構文

T|where大佐in(式, ... )

構文規則について詳しく知る。

パラメーター

名前	型	必須	説明
T	string	✔️	フィルター処理する表形式の入力。
col	string	✔️	フィルター処理の対象となる列。
式 (expression)	スカラーまたは表形式	✔️	検索する値を指定する式。 検索する値。 各式には、 スカラー 値、または値のセットを生成する 表形式の式 を指定できます。 表形式の式に複数の列がある場合は、最初の列が使用されます。 検索では、最大 1,000,000 個の個別の値が考慮されます。

Note

インライン表形式の式は、二重かっこで囲む必要があります。 例を参照してください。

戻り値

述語が true である T 内の行。

例

スカラーの一覧

次のクエリは、スカラー値の一覧で を使用 in する方法を示しています。

クエリを実行する

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

出力

Count
4775

Dynamic array

次のクエリは、動的配列で を使用 in する方法を示しています。

クエリを実行する

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

出力

Count
3218

表形式の式

次のクエリは、表形式の式で を使用 in する方法を示しています。

クエリを実行する

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

インライン表形式の式ステートメントを使用して、同じクエリを記述できます。

クエリを実行する

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

出力

Count
14242

Top とその他の例

クエリを実行する

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 

出力

州	sum_lightning_events
ALABAMA	29
WISCONSIN	31
テキサス州	55
FLORIDA	85
GEORGIA	106
その他	415

関数によって返される静的リストを使用

クエリを実行する

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

出力

Count
4775

関数の定義。

クエリを実行する

.show function InterestingStates

出力

名前	パラメーター	本文	フォルダー	DocString
InterestingStates	()	{ dynamic(["WASHINGTON", "FLORIDA", "GEORGIA", "NEW YORK"]) }