使用传递给运算符的表格格式数据流。
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 运算符不向客户端返回任何数据。