Operatore project

Selezionare le colonne da includere, rinominare o rimuovere e inserire le nuove colonne calcolate.

L'ordine delle colonne nel risultato viene specificato dall'ordine degli argomenti. Nel risultato vengono incluse solo le colonne specificate negli argomenti. Tutte le altre colonne dell'input vengono rimosse.

Sintassi

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

oppure

T| projectColumnName [=Expression] [, ...]

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
T string ✔️ Input tabulare per il quale proiettare determinate colonne.
ColumnName string Un nome di colonna o un elenco delimitato da virgole di nomi di colonna da visualizzare nell'output.
Espressione string Espressione scalare da eseguire sull'input.
  • È necessario specificare ColumnName o Expression .
  • Se non è presente alcuna espressione, nell'input deve essere visualizzata una colonna ColumnName .
  • Se ColumnName viene omesso, il nome della colonna di output di Expression verrà generato automaticamente.
  • Se Expression restituisce più di una colonna, è possibile specificare un elenco di nomi di colonna tra parentesi. Se non viene specificato un elenco dei nomi di colonna, all'output verranno aggiunte tutte le colonne di output di Expression con nomi generati.

Nota

Non è consigliabile restituire una nuova colonna calcolata con lo stesso nome di una colonna esistente nell'input.

Restituisce

Tabella con colonne denominate come argomenti. Contiene lo stesso numero di righe della tabella di input.

Esempio

Mostra solo colonne specifiche

Mostra solo l'oggetto EventId, StateEventType della StormEvents tabella .

StormEvents
| project EventId, State, EventType

La tabella dei risultati seguente mostra solo i primi 10 risultati.

EventId State EventType
61032 SUD ATLANTICO Tromba marina
60904 FLORIDA Pioggia intensa
60913 FLORIDA Tornado
64588 GEORGIA Vento di tempesta
68796 MISSISSIPPI Vento di tempesta
68814 MISSISSIPPI Tornado
68834 MISSISSIPPI Vento di tempesta
68846 MISSISSIPPI Grandine
73241 AMERICAN SAMOA Piena improvvisa
64725 KENTUCKY Alluvione
... ... ...

Potenziali manipolazioni che usano il progetto

La query seguente rinomina la BeginLocation colonna e crea una nuova colonna chiamata TotalInjuries da un calcolo su due colonne esistenti.

StormEvents
| project StartLocation = BeginLocation, TotalInjuries = InjuriesDirect + InjuriesIndirect
| where TotalInjuries > 5

La tabella seguente mostra solo i primi 10 risultati.

StartLocation TotalInjuries
LYDIA 15
REGALE 15
GÖTEBORG 9
PIANURE 8
KNOXVILLE 9
CAROL STREAM 11
HOLLY 9
RUFFIN 9
ENTERPRISE MUNI ARPT 50
COLLIERVILLE 6
... ...