Оператор !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().

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

Примечание.

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

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

Синтаксис

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
54,291

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

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

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

StormEvents 
| where State !in~ (dynamic(["Florida", "Georgia", "New York"])) 
| count

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

Count
54291

Тот же запрос также можно записать с помощью инструкции let.

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

let states = dynamic(["Florida", "Georgia", "New York"]);
StormEvents 
| where State !in~ (states)
| summarize count() by State

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

Count
54291

Табличное выражение

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

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

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

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

Штат	count_
КАНЗАС	3166
АЙОВА	2337
НЕБРАСКА	1766
ОКЛАХОМА	1716
ЮЖНАЯ ДАКОТА	1567
...	...

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

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

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

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

Штат	count_
КАНЗАС	3166
АЙОВА	2337
НЕБРАСКА	1766
ОКЛАХОМА	1716
ЮЖНАЯ ДАКОТА	1567
...	...