toscalar()

適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel

傳回評估表達式的純量常數值。

此函式適用於需要分段計算的查詢。 例如，計算事件總數，然後使用結果來篩選超過所有事件特定百分比的群組。

任何兩個語句都必須以分號分隔。

語法

toscalar(expression)

深入瞭解 語法慣例。

參數

傳回

評估表達式的純量常數值。 如果結果為表格式，則會採用第一個數據行和第一個數據列進行轉換。

限制

toscalar() 無法套用在每個數據列上套用函式的案例。 這是因為函式只能在查詢執行期間計算常數次。 通常，當達到此限制時，將會傳回下列錯誤： can't use '<column name>' as it is defined outside its row-context scope.

在下列範例中，查詢失敗，並出現錯誤：

'toscalar': can't use 'x' as it is defined outside its row-context scope.

let _dataset1 = datatable(x:long)[1,2,3,4,5];
let _dataset2 = datatable(x:long, y:long) [ 1, 2, 3, 4, 5, 6];
let tg = (x_: long)
{
    toscalar(_dataset2| where x == x_ | project y);
};
_dataset1
| extend y = tg(x)

使用 join 運算子可以減輕此失敗，如下列範例所示：

let _dataset1 = datatable(x: long)[1, 2, 3, 4, 5];
let _dataset2 = datatable(x: long, y: long) [1, 2, 3, 4, 5, 6];
_dataset1
| join (_dataset2) on x 
| project x, y

輸出

範例

評估 Start、 End和 Step 做為純量常數，並使用結果進行評估 range 。

let Start = toscalar(print x=1);
let End = toscalar(range x from 1 to 9 step 1 | count);
let Step = toscalar(2);
range z from Start to End step Step | extend start=Start, end=End, step=Step

輸出

下列範例示範如何使用 toscalar 來「修正」表達式，以便精確地計算一次。 在此情況下，所計算的運算式會針對每個評估傳回不同的值。

let g1 = toscalar(new_guid());
let g2 = new_guid();
range x from 1 to 2 step 1
| extend x=g1, y=g2

輸出