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")

注意

入れ子になった配列は、単一の値リストにフラット化されます。 たとえば、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 個の個別の値が考慮されます。

戻り値

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

例

スカラーの一覧

次のクエリは、スカラー値のコンマ区切りのリストで を使用 in~ する方法を示しています。

クエリを実行する

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

出力

Count
4775

Dynamic array

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

クエリを実行する

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

出力

Count
4775

同じクエリを let ステートメントで記述することもできます。

クエリを実行する

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

出力

Count
4775

表形式の式

次のクエリは、インライン表形式式で を使用 in~ する方法を示しています。 インライン表形式の式は、二重かっこで囲む必要があることに注意してください。

クエリを実行する

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

出力

State	count_
テキサス州	4701
ILLINOIS	2022
MISSOURI	2016
GEORGIA	1983
ミネソタ	1881
...	...

同じクエリを let ステートメントで記述することもできます。 この場合、最後の例で示した二重かっこは不要であることに注意してください。

クエリを実行する

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

出力

State	count_
テキサス州	4701
ILLINOIS	2022
MISSOURI	2016
GEORGIA	1983
ミネソタ	1881
...	...