Оператор !contains_cs

  • Статья

Фильтрует набор записей по данным, которые не содержат строку с учетом регистра. !contains_cs ищет символы, а не термины из трех или более символов. Запрос сканирует значения в столбце, который выполняется медленнее, чем поиск термина в индексе термина.

В следующей таблице сравниваются операторы contains с использованием указанных сокращений:

  • RHS = правая часть выражения
  • LHS = левая часть выражения
Оператор Описание С учетом регистра Пример (при true)
contains RHS возникает как последовательность LHS Нет "FabriKam" contains "BRik"
!contains RHS не возникает в LHS Нет "Fabrikam" !contains "xyz"
contains_cs RHS возникает как последовательность LHS Да "FabriKam" contains_cs "Kam"
!contains_cs RHS не возникает в LHS Да "Fabrikam" !contains_cs "Kam"

Дополнительные сведения о других операторах и определении того, какой оператор лучше всего подходит для запроса, см. в разделе Строковые операторы типа данных.

Советы по улучшению производительности

Примечание

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

Если вы ищете термин, используйте !has_cs для более быстрых результатов.

Синтаксис

Синтаксис с учетом регистра

T|whereСтолбца!contains_cs(Выражение)

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

Параметры

Имя Тип Обязательно Описание
T string ✔️ Табличные входные данные, записи которых должны быть отфильтрованы.
Столбец string ✔️ Столбец, по которому выполняется фильтрация.
Выражение скаляр ✔️ Скалярное или литеральное выражение, для которого выполняется поиск.

Возвращаемое значение

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

Примеры

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

StormEvents
| summarize event_count=count() by State
| where State !contains_cs "AS"
| count

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

Count
59

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

StormEvents
| summarize event_count=count() by State
| where State !contains_cs "TEX"
| where event_count > 3000
| project State, event_count

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

Состояние event_count
Канзас 3,166