project 运算符
选择要包含、重命名或删除的列,并插入新的计算列。
结果中的列顺序由参数的顺序指定。 只有在参数中指定的列才包含在结果中。 输入中的任何其他列都会被删除。
语法
T | project
[ColumnName | (
ColumnName[,
])
=
] Expression [,
...]
或
T | project
ColumnName [=
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 |
... | ... |