Оператор where

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

Отфильтровывает таблицу для подмножества строк, которые удовлетворяют предикату.

where Операторы filter эквивалентны

Синтаксис

T| whereпредикат

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

Параметры

Возвраты

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

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

• Используйте простые сравнения между именами столбцов и константами. (Под константой здесь понимается значение, постоянное для всех строк таблицы. Соответственно, допустимо использовать функции now() и ago(), а также скалярные значения, назначенные с помощью оператора let.)

  Например, лучше использовать where Timestamp >= ago(1d), чем where bin(Timestamp, 1d) == ago(1d).

• Вводите сначала более простые элементы. Если у вас есть несколько предложений, объединенных с помощью and, то сначала вводите предложения, которые включают только один столбец. Пример правильного порядка предложений: Timestamp > ago(1d) and OpId == EventId.

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

Примеры

Сравнение заказов по сложности

Следующий запрос возвращает записи шторма, сообщающие о поврежденном свойстве, являются наводнениями и начинаются и заканчиваются в разных местах.

Обратите внимание, что мы ставим сравнение между двумя столбцами последним, так как оператор не может использовать индекс и принудительно сканирует.

StormEvents
| project DamageProperty, EventType, BeginLocation, EndLocation
| where DamageProperty > 0
    and EventType == "Flood"
    and BeginLocation != EndLocation 

В следующей таблице показаны только первые 10 результатов. Чтобы просмотреть полные выходные данные, выполните запрос.

Проверьте, содержит ли столбец строку

Следующий запрос возвращает строки, в которых слово "корова" отображается в любом столбце.

StormEvents
| where * has "cow"