Оператор project

  • Статья

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

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

Синтаксис

T| project [ColumnName | (ColumnName[,])=] Выражение [, ...]

или

T| projectColumnName [=Expression] [, ...]

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

Параметры

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

Примечание

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

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

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

Примеры

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

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

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

StormEvents
| project EventId, State, EventType

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

EventId Состояние EventType
61032 ЮЖНО-АТЛАНТИЧЕСКИЕ ШТАТЫ Торнадо
60904 Флорида Сильный ливень
60913 Флорида Ураган
64588 Грузия Шквалистый ветер
68796 Миссисипи Шквалистый ветер
68814 Миссисипи Ураган
68834 Миссисипи Шквалистый ветер
68846 Миссисипи Град
73241 АМЕРИКАНСКОЕ САМОА Внезапное наводнение
64725 КЕНТУККИ Наводнение
... ... ...

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

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

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

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

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

StartLocation TotalInjuries
ЛИДИЯ 15
КОРОЛЕВСКИЙ 15
ГЁТЕБОРГ 9
РАВНИНЫ 8
НОКСВИЛЛ 9
КЭРОЛ СТРИМ 11
ХОЛЛИ 9
RUFFIN 9
ENTERPRISE MUNI ARPT 50
КОЛЬЕРВИЛЛЬ 6
... ...

См. также