Оператор contains

Статья
11/23/2024

Область применения: ✅Microsoft Fabric ✅Azure Data Explorer✅Azure Monitor ✅Microsoft Sentinel

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

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

RHS = справа от выражения
LHS = левая сторона выражения

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

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

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

Примечание.

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

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

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

Синтаксис

T | where col string contains_cs ()

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

Параметры

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

Возвраты

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

Пример

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

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

Поделиться через