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


project operator

Applies to: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

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

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

Syntax

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

or

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

Learn more about syntax conventions.

Parameters

Name Type Required Description
T string ✔️ Табличные входные данные, для которых необходимо проецировать определенные столбцы.
ColumnName string Имя столбца или разделенный запятыми список имен столбцов, отображаемых в выходных данных.
Expression string Скалярное выражение, выполняемое по входным данным.
  • Either ColumnName or Expression must be specified.
  • If there's no Expression, then a column of ColumnName must appear in the input.
  • If ColumnName is omitted, the output column name of Expression will be automatically generated.
  • If Expression returns more than one column, a list of column names can be specified in parentheses. If a list of the column names isn't specified, all Expression's output columns with generated names will be added to the output.

Note

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

Returns

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

Examples

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

The examples in this article use publicly available tables in the help cluster, such as the StormEvents table in the Samples database.

The examples in this article use publicly available tables, such as the Weather table in the Weather analytics sample gallery. Возможно, потребуется изменить имя таблицы в примере запроса, чтобы она соответствовала таблице в рабочей области.

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

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

StormEvents
| project EventId, State, EventType

Output

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

EventId State EventType
61032 ATLANTIC SOUTH Waterspout
60904 FLORIDA Heavy Rain
60913 FLORIDA Tornado
64588 GEORGIA Thunderstorm Wind
68796 MISSISSIPPI Thunderstorm Wind
68814 MISSISSIPPI Tornado
68834 MISSISSIPPI Thunderstorm Wind
68846 MISSISSIPPI Hail
73241 AMERICAN SAMOA Flash Flood
64725 KENTUCKY Flood
... ... ...

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

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

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

Output

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

StartLocation TotalInjuries
LYDIA 15
ROYAL 15
GOTHENBURG 9
PLAINS 8
KNOXVILLE 9
CAROL STREAM 11
HOLLY 9
RUFFIN 9
ENTERPRISE MUNI ARPT 50
COLLIERVILLE 6
... ...