consume 运算符

适用于:✅Azure 数据资源管理器Azure MonitorMicrosoft Sentinel

使用传递给运算符的表格格式数据流。

consume 运算符主要用于触发查询副作用,实际上不会将结果返回给调用方。

consume 运算符可用于估算查询的成本,实际上不会将结果传递回客户端。 (由于多种原因,估算不准确。例如,consume 是进行分布式计算的,因此 T | consume 不会在群集的节点之间传输表的数据。)

语法

consume [decodeblocks=DecodeBlocks]

详细了解语法约定

参数

客户 类型​​ 必需 说明
DecodeBlocks bool 如果将其设置为 true,或者将请求属性 perftrace 设置为 true,则 consume 操作符不仅会枚举其输入中的记录,实际上也会强制解压缩和解码这些记录中的每个值。

退货

运算符 consume 返回与其输入相同的表格数据流,但不会将数据返回到客户端。

例子

以下示例演示如何使用 consume 运算符触发查询副作用,而不实际将结果返回给调用方。

StormEvents
| where State == "TEXAS"
| consume

在此示例中,查询会筛选 StormEvents 表,其中行为 State “TEXAS”,然后应用 consume 运算符。 处理数据,但不会向客户端返回任何结果。

输出 结果表为空,因为 consume 运算符不向客户端返回任何数据。