Condividi tramite

Operatore extend

  • Articolo

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati✅ Azure Monitor✅Microsoft Sentinel

Crea colonne calcolate e le aggiunge al set di risultati.

Sintassi

T | extend [NomeColonna | (NomeColonna[, ...]) =] Espressione [, ...]

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
T string ✔️ Input tabulare da estendere.
ColumnName string Nome della colonna da aggiungere o aggiornare.
Expression string ✔️ Calcolo da eseguire sull'input.
  • Se ColumnName viene omesso, il nome della colonna di output di Expression viene generato automaticamente.
  • Se Espressione restituisce più di una colonna, è possibile specificare un elenco di nomi di colonna tra parentesi. Alle colonne di output di Expression vengono quindi assegnati i nomi specificati. Se non viene specificato un elenco dei nomi di colonna, all'output vengono aggiunte tutte le colonne di output di Expression con nomi generati.

Valori restituiti

Una copia del set di risultati tabulare di input, in modo che:

  1. I nomi di colonna indicati da extend già presenti nell'input siano rimossi e accodati come nuovi valori calcolati.
  2. I nomi delle colonne annotati da extend che non esistono nell'input vengono accodati come nuovi valori calcolati.

Nota

L'operatore extend aggiunge una nuova colonna al set di risultati di input, che non prevede un indice. Nella maggior parte dei casi, se la nuova colonna viene impostata in modo che corrisponda esattamente a una colonna di tabella esistente con un indice, Kusto può usare automaticamente l'indice esistente. Tuttavia, in alcuni scenari complessi questa propagazione non viene eseguita. In questi casi, se l'obiettivo consiste nel rinominare una colonna, usare invece l'operatore project-rename.

Esempio

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

La tabella seguente mostra solo i primi 10 risultati. Per visualizzare l'output completo, eseguire la query.

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

Contenuto correlato