project 运算符
选择要包含、重命名或删除的列，并插入新的计算列。
结果中的列顺序由参数的顺序指定。 只有在参数中指定的列才包含在结果中。 输入中的任何其他列都会被删除。
语法
T| project [ColumnName | (ColumnName[,])=] Expression [, ...]
or
T| projectColumnName [=Expression] [, ...]
详细了解语法约定。
参数
| 客户 | 类型 | 必需 | 说明 |
|---|---|---|---|
| T | string |
✔ | 要为其投影某些列的表格输入。 |
| ColumnName | string |
要在输出中显示的列名或逗号分隔的列名列表。 | |
| Expression | string |
要对输入执行的标量表达式。 |
- 必须指定 ColumnName 或 Expression。
- 如果没有 Expression，则输入中必须有 ColumnName 列。
- 如果省略 ColumnName，则会自动生成 Expression 的输出列名。
- 如果 Expression 返回多个列，则可在括号中指定列名列表。 如果未指定列名列表，则 Expression 的所有具有所生成名称的输出列都将添加到输出中。
注意
不建议返回与输入中的现有列同名的新计算列。
返回
一个包含指定为参数的列的表。 包含与输入表相同的行数。
示例
仅显示特定列
仅显示 StormEvents 表的 EventId、State、EventType。
StormEvents
| project EventId, State, EventType
以下结果表仅显示前 10 个结果。
| EventId | 状态 | EventType |
|---|---|---|
| 61032 | 大西洋南部 | Waterspout |
| 60904 | 佛罗里达州 | 暴雨 |
| 60913 | 佛罗里达州 | 龙卷风 |
| 64588 | 佐治亚州 | 雷雨大风 |
| 68796 | 密西西比州 | 雷雨大风 |
| 68814 | 密西西比州 | 龙卷风 |
| 68834 | 密西西比州 | 雷雨大风 |
| 68846 | 密西西比州 | 冰雹 |
| 73241 | AMERICAN SAMOA | 山洪 |
| 64725 | KENTUCKY | 洪水 |
| ... | ... | ... |
使用项目的潜在操作
以下查询重命名 BeginLocation 列，并根据对两个现有列的计算创建一个名为 TotalInjuries 的新列。
StormEvents
| project StartLocation = BeginLocation, TotalInjuries = InjuriesDirect + InjuriesIndirect
| where TotalInjuries > 5
下表仅显示前 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 |
| ... | ... |