Оператор in~

Фильтрует набор записей для данных с нечувствительной строкой регистра.

В следующей таблице приведено сравнение in операторов:

Operator	Description	С учетом регистра	Пример (при true)
in	Соответствует одному из элементов	Да	"abc" in ("123", "345", "abc")
!in	Не соответствует одному из элементов	Да	"bca" !in ("123", "345", "abc")
in~	Равно любому из элементов	No	"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().

Советы по производительности

Примечание.

Производительность зависит от типа поиска и структуры данных. Рекомендации см. в разделе "Рекомендации по запросу".

По возможности используйте регистр.

Синтаксис

T | where col (in~ expression ...,)

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название)	Type	Обязательно	Описание
T	string	✔️	Табличные входные данные для фильтрации.
col	string	✔️	Столбец, по которому необходимо отфильтровать.
выражение	скалярный или табличный	✔️	Выражение, указывающее значения, для которых выполняется поиск. Каждое выражение может быть скалярным значением или табличным выражением, которое создает набор значений. Если табличное выражение содержит несколько столбцов, используется первый столбец. Поиск рассмотрит до 1000 000 различных значений.

Возвраты

Строки в T, для которых предикат имеет значение true.

Примеры

Список скалярных

В следующем запросе показано, как использовать in~ с разделенным запятыми список скалярных значений.

Выполнить запрос

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

Выходные данные

Count
4775

Динамический массив

В следующем запросе показано, как использовать 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

Выходные данные

Штат	count_
TEXAS	4701
ИЛЛИНОЙС	2022
МИССУРИ	2016
ДЖОРДЖИЯ	1983
МИННЕСОТА	1881
...	...

Тот же запрос также можно записать с помощью инструкции let. Обратите внимание, что двойные скобки, как указано в последнем примере, не нужны в этом случае.

Выполнить запрос

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

Выходные данные

Штат	count_
TEXAS	4701
ИЛЛИНОЙС	2022
МИССУРИ	2016
ДЖОРДЖИЯ	1983
МИННЕСОТА	1881
...	...