Operatore extend

  • Articolo

Crea colonne calcolate e le accoda al set di risultati.

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
T string ✔️ Input tabulare da estendere.
ColumnName string Nome della colonna da aggiungere o aggiornare.
Espressione string ✔️ Calcolo da eseguire sull'input.
  • Se ColumnName viene omesso, il nome della colonna di output di Expression viene generato automaticamente.
  • Se Expression 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.

Restituisce

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 di colonna annotati da extend che non esistono nell'input vengono aggiunti 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

Eseguire la query

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

Contenuti correlati