Оператор contains

Переключайте службы с помощью раскрывающегося списка Версия. Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

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

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

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

Дополнительные сведения о других операторах и определении наиболее подходящих операторов для запроса см. в разделе строковых операторов типа данных.

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

Примечание.

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

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

Если вы ищете термин, используйте has для ускорения результатов.

Синтаксис

T|wherecol stringcontains_cs()

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

Параметры

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

Возвраты

Строки в T , для которых строка находится в col.

Примеры

В следующем примере показано, как использовать contains оператор.

StormEvents
| summarize event_count=count() by State
| where State contains "enn"
| where event_count > 10
| project State, event_count
| render table

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

Штат event_count
ПЕНСИЛЬВАНИЯ 1687
ТЕННЕССИ 1125