project 运算符

选择要包含、重命名或删除的列,并插入新的计算列。

结果中的列顺序由参数的顺序指定。 只有在参数中指定的列才包含在结果中。 输入中的任何其他列都会被删除。

语法

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

or

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

参数

名称 类型 必需 说明
T 字符串 要从中投影某些列的表格输入。
ColumnName 字符串 要在输出中显示的列的名称。
表达式 字符串 要对输入执行的标量表达式。
  • 必须指定 ColumnNameExpression
  • 如果没有 Expression,则输入中必须有 ColumnName 的列。
  • 如果省略 ColumnName,则会自动生成 Expression 的输出列名。
  • 如果 Expression 返回多个列,则可在括号中指定列名列表。 如果未指定列名列表,则 Expression 的所有具有所生成名称的输出列都将添加到输出中。

注意

允许但不建议返回与输入中的现有列同名的新计算列。

返回

一个包含指定为参数的列的表。 包含与输入表相同的行数。

示例

仅显示特定列

仅显示 StormEvents 表的 EventIdStateEventType

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
... ...

请参阅