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


Оператор project

Область применения: ✅Microsoft Fabric

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

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

Синтаксис

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

or

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

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

Параметры

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

Примечание.

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

Возвраты

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

Примеры

В примерах этого раздела показано, как использовать синтаксис для начала работы.

Примеры, приведенные в этой статье, используют общедоступные таблицы в кластера, например таблицу StormEvents в базе данных Samples.

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

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

Отображается EventIdтолько таблица , StateEventTypeиз 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
... ...