Dela via


utöka operatorn

Gäller för: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

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

Syntax

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

Läs mer om syntaxkonventioner.

Parameterar

Namn Typ Krävs Beskrivning
T string ✔️ Tabellindata som ska utökas.
KolumnNamn 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 uttryck returnerar mer än en kolumn kan en lista med kolumnnamn anges inom parenteser. Sedan får uttrycksutdatakolumnerna de angivna namnen. Om en lista över kolumnnamnen inte har angetts läggs alla utdatakolumner för uttryck med genererade namn till i utdata.

Retur

Returnerar en kopia av resultatuppsättningen för indata i tabellform, så att:

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

Anmärkning

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

I följande exempel visas hur du använder operatorn extend för att skapa en ny kolumn med namnet Duration som beräknar skillnaden mellan kolumnerna EndTime och StartTime i StormEvents tabellen.

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

Följande tabell visar endast de första 10 resultaten. Kör frågan för att se hela utdata.

Sluttid Starttid 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