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


Оператор project

Выбор столбцов, которые нужно включить, переименовать или перетащить, и вставка новых вычисляемых столбцов.

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

Синтаксис

T | project [ColumnName | (ColumnName[,]) =] Expression [, ...]

or

T | project ColumnName [= Expression] [, ...]

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

Параметры

Имя (название) Type Обязательно Описание
T string ✔️ Табличные входные данные, для которых необходимо проецировать определенные столбцы.
ColumnName string Имя столбца или разделенный запятыми список имен столбцов, отображаемых в выходных данных.
Выражение string Скалярное выражение, выполняемое по входным данным.
  • Необходимо указать имя столбца или выражение.
  • Если выражения нет, в входных данных должен появиться столбец ColumnName.
  • Если имя столбца опущено, имя выходного столбца выражения будет автоматически создано.
  • Если Expression возвращает более одного столбца, список имен столбцов можно указать в скобках. Если список имен столбцов не указан, все выходные столбцы выражения с созданными именами будут добавлены в выходные данные.

Примечание.

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

Возвраты

Таблица со столбцами, которые были названы в качестве аргументов. Содержит то же количество строк, что и входная таблица.

Примеры

Отображение только определенных столбцов

Отображается EventIdтолько таблица , EventType Stateиз StormEvents таблицы.

StormEvents
| project EventId, State, EventType

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

EventId Штат EventType
61032 ЮЖНАЯ АТЛАНТИКА Waterspout
60904 FLORIDA Ливень
60913 FLORIDA Торнадо
64588 ДЖОРДЖИЯ Ураганный ветер
68796 МИССИСИПИ Ураганный ветер
68814 МИССИСИПИ Торнадо
68834 МИССИСИПИ Ураганный ветер
68846 МИССИСИПИ Град
73241 АМЕРИКАНСКОЕ САМОА Паводок
64725 KENTUCKY Наводнение
... ... ...

Потенциальные манипуляции с помощью проекта

Следующий запрос переименовывает BeginLocation столбец и создает новый столбец, вызываемый TotalInjuries из вычисления по двум существующим столбцам.

StormEvents
| project StartLocation = BeginLocation, TotalInjuries = InjuriesDirect + InjuriesIndirect
| where TotalInjuries > 5

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

StartLocation TotalInjuries
ЛИДИЯ 15
КОРОЛЕВСКИЙ 15
ГЁТЕБОРГ 9
РАВНИНЫ 8
НОКСВИЛЛ 9
CAROL STREAM 11
ПАДУБ 9
RUFFIN 9
ENTERPRISE MUNI ARPT 50
COLLIERVILLE 6
... ...