extend 運算子

建立匯出數據行,並將其附加至結果集。

語法

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

深入瞭解 語法慣例

參數

名稱 類型 必要 Description
T string ✔️ 要擴充的表格式輸入。
ColumnName string 要加入或更新的數據行名稱。
運算式 string ✔️ 要對輸入執行的計算。
  • 如果省略 ColumnName ,則會自動產生 Expression 的輸出數據行名稱。
  • 如果 Expression 傳回多個資料行,則可以在括弧中指定資料行名稱清單。 然後, 表達式的輸出數據行會指定指定的名稱。 如果未指定數據行名稱清單,則所有具有所產生名稱的 Expression 輸出資料行都會新增至輸出。

傳回

輸入表格式結果集的複本,以致:

  1. extend 所記下、已存在於輸入中的資料行名稱會遭到移除,並以其新計算值的形式予以附加。
  2. 輸入 extend 中不存在的數據行名稱會附加為新的導出值。

注意

extend 運算子會將新的資料行新增至輸入結果集,這不會有索引。 在大多數情況下,如果新的資料行設定為與具有索引的現有資料表資料行完全相同,則 Kusto 可以自動使用現有的索引。 不過,在某些複雜的案例中,則不會進行這項傳播。 在這類情況下,如果目標是要重新命名資料行,則請改用 運算子。

範例

StormEvents
| project EndTime, StartTime
| extend Duration = EndTime - StartTime

下表只顯示前10個結果。 若要查看完整的輸出,請執行查詢。

EndTime StartTime Duration
2007-01-01T00:00:00Z 2007-01-01T00:00:00Z 00:00:00
2007-01-01T00:25:00Z 2007-01-01T00:25:00Z 00:00:00
2007-01-01T02:24:00Z 2007-01-01T02:24:00Z 00:00:00
2007-01-01T03:45:00Z 2007-01-01T03:45:00Z 00:00:00
2007-01-01T04:35:00Z 2007-01-01T04:35:00Z 00:00:00
2007-01-01T04:37:00Z 2007-01-01T03:37:00Z 01:00:00
2007-01-01T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
2007-01-01T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
2007-01-01T06:00:00Z 2007-01-01T00:00:00Z 06:00:00
2007-01-01T06:00:00Z 2007-01-01T00:00:00Z 06:00:00