Оператор project
Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Выбор столбцов, которые нужно включить, переименовать или перетащить, и вставка новых вычисляемых столбцов.
Порядок столбцов в результате определяется порядком аргументов. В результат будут включены только указанные в аргументах столбцы. Другие столбцы во входных данных удаляются.
Синтаксис
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 |
... | ... |