extend-operatorn

  • Artikel

Skapar beräknade kolumner och lägger till dem i resultatuppsättningen.

Syntax

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

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
T string ✔️ Tabellindata som ska utökas.
Columnname string Namnet på kolumnen som ska läggas till eller uppdateras.
Uttryck string ✔️ Beräkning som ska utföras över indata.
  • Om ColumnName utelämnas genereras utdatakolumnnamnet för Uttryck automatiskt.
  • Om Uttrycket returnerar mer än en kolumn kan en lista med kolumnnamn anges inom parentes. Sedan får uttrycksutdatakolumnerna de angivna namnen. Om en lista över kolumnnamnen inte anges läggs alla uttrycksutdatakolumner med genererade namn till i utdata.

Returer

En kopia av resultatuppsättningen för indataflikar, så att:

  1. Kolumnnamn som anges av extend som redan finns i indata tas bort och läggs till som nya beräknade värden.
  2. Kolumnnamn som anges av extend som inte finns i indata läggs till som nya beräknade värden.

Anteckning

Operatorn extend lägger till en ny kolumn i indataresultatuppsättningen, som inte har något index. I de flesta fall, om den nya kolumnen är inställd på exakt samma som en befintlig tabellkolumn som har ett index, kan Kusto automatiskt använda det befintliga indexet. I vissa komplexa scenarier görs dock inte den här spridningen. Om målet i sådana fall är att byta namn på en kolumn använder du operatornproject-rename i stället.

Exempel

Köra frågan

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

Följande tabell visar endast de första 10 resultaten. Kör frågan om du vill se fullständiga utdata.

EndTime StartTime Varaktighet
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

Relaterat innehåll