Let 语句

• 06/07/2021
• • o
  • a
  • v

Let 语句将名称绑定到表达式。 对于作用域中出现了 let 语句的其余部分，可以使用名称来引用其绑定值。 Let 语句的作用域可以是全局，也可以是某个函数主体。 如果该名称以前绑定到另一个值，则使用“innermost”let 语句绑定。

Let 语句改善了模块化和重用，因为它们允许你将可能复杂的表达式分解为多个部分。 每个部分都通过 let 语句绑定到一个名称，它们共同构成了整个表达式。 它们还可用于创建用户定义的函数和视图。 视图是基于表的表达式，其结果看起来像新表。

Let 语句绑定的表达式可以是：

• 标量类型
• 表格类型
• 用户定义的函数 (lambda)

语法

let Name = ScalarExpression | TabularExpression | FunctionDefinitionExpression

Lambda 表达式语法

[view] ([TabularArguments][,][ScalarArguments]) { FunctionBody }

TabularArguments - [TabularArgName : ([AtrName : AtrType] [, ... ])] [, ... ][,]

或者：

[TabularArgName : ( * )] - 指示包含变量列和未知列的表格表达式。

ScalarArguments - [ArgName : ArgType] [, ... ]

多个嵌套的 let 语句

多个 let 语句可以一起使用，以分号 ; 作为分隔符，如以下示例所示。

let start = ago(5h); 
let period = 2h; 
T | where Time > start and Time < start + period | ...

允许使用嵌套的 let 语句，可将其用在 lambda 表达式中。 Let 语句和自变量在函数主体的当前作用域和内部作用域中可见。

let start_time = ago(5h); 
let end_time = start_time + 2h; 
T | where Time > start_time and Time < end_time | ...

示例

使用 let 函数定义常量

下面的示例将名称 x 绑定到标量文本 1，然后在表格表达式语句中使用它。

let x = 1;
range y from x to x step x

此示例与前一个示例类似，在使用 ['name'] 表示法时仅提供 let 语句的名称。

let ['x'] = 1;
range y from x to x step x

将 let 用于标量值

let n = 10;  // number
let place = "Dallas";  // string
let cutoff = ago(62d); // datetime
Events 
| where timestamp > cutoff 
    and city == place 
| take n

使用带有自变量的 let 语句进行标量计算

此示例使用带有自变量的 let 语句进行标量计算。 该查询定义了用于将两个数字相乘的函数 MultiplyByN。

let MultiplyByN = (val:long, n:long) { val * n };
range x from 1 to 5 step 1 
| extend result = MultiplyByN(x, 5)

以下示例删除输入中的前导/尾随 1。

let TrimOnes = (s:string) { trim("1", s) };
range x from 10 to 15 step 1 
| extend result = TrimOnes(tostring(x))

使用多个 let 语句

此示例定义了两个 let 语句，其中一个语句 (foo2) 使用另一个语句 (foo1)。

let foo1 = (_start:long, _end:long, _step:long) { range x from _start to _end step _step};
let foo2 = (_step:long) { foo1(1, 100, _step)};
foo2(2) | count
// Result: 50

在 let 语句中使用 view 关键字

此示例演示了如何将 let 语句与 view 关键字一起使用。

let Range10 = view () { range MyColumn from 1 to 10 step 1 };
let Range20 = view () { range MyColumn from 1 to 20 step 1 };
search MyColumn == 5

使用 materialize 函数

materialize 函数允许在执行查询时缓存子查询结果。

let totalPagesPerDay = PageViews
| summarize by Page, Day = startofday(Timestamp)
| summarize count() by Day;
let materializedScope = PageViews
| summarize by Page, Day = startofday(Timestamp);
let cachedResult = materialize(materializedScope);
cachedResult
| project Page, Day1 = Day
| join kind = inner
(
    cachedResult
    | project Page, Day2 = Day
)
on Page
| where Day2 > Day1
| summarize count() by Day1, Day2
| join kind = inner
    totalPagesPerDay
on $left.Day1 == $right.Day
| project Day1, Day2, Percentage = count_*100.0/count_1