Operatore projectproject operator

Selezionare le colonne da includere, rinominare o rimuovere e inserire le nuove colonne calcolate.Select the columns to include, rename or drop, and insert new computed columns.

L'ordine delle colonne nel risultato viene specificato dall'ordine degli argomenti.The order of the columns in the result is specified by the order of the arguments. Nel risultato vengono incluse solo le colonne specificate negli argomenti.Only the columns specified in the arguments are included in the result. Tutte le altre colonne nell'input vengono eliminate.Any other columns in the input are dropped. Vedere anche extend.(See also extend.)

T | project cost=price*quantity, price

SintassiSyntax

T | project ColumnName [ = espressione] [ , ...]T | project ColumnName [= Expression] [, ...]

oppureor

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

ArgomentiArguments

  • T: tabella di input.T: The input table.

  • ColumnName: Nome facoltativo di una colonna da visualizzare nell'output.ColumnName: Optional name of a column to appear in the output. Se non è presente alcuna espressione, ColumnName è obbligatoria e una colonna con tale nome deve essere visualizzata nell'input.If there is no Expression, then ColumnName is mandatory and a column of that name must appear in the input. Se omesso, il nome verrà generato automaticamente.If omitted, the name will be automatically generated. Se Expression restituisce più di una colonna, è possibile specificare un elenco di nomi di colonna tra parentesi.If Expression returns more than one column, a list of column names can be specified in parentheses. In questo caso, alle colonne di output dell' espressioneverranno assegnati i nomi specificati, eliminando tutte le altre colonne di output, se presenti.In this case Expression's output columns will be given the specified names, dropping all rest of the output columns, if there are any. Se non si specifica l'elenco dei nomi di colonna, verranno aggiunte all'output tutte le colonne di output dell' espressionecon nomi generati.If list of the column names is not specified, all Expression's output columns with generated names will be added to the output.

  • Expression: espressione scalare facoltativa che fa riferimento alle colonne di input.Expression: Optional scalar expression referencing the input columns. Se ColumnName non viene omesso, Expression è obbligatorio.If ColumnName is not omitted then Expression is mandatory.

    È consentito restituire una nuova colonna calcolata con lo stesso nome di una colonna esistente nell'input.It is legal to return a new calculated column with the same name as an existing column in the input.

RestituisceReturns

Una tabella che ha le colonne denominate come argomenti e lo stesso numero di righe della tabella di input.A table that has the columns named as arguments, and as many rows as the input table.

EsempioExample

L'esempio seguente illustra diverse tipologie di manipolazioni che possono essere eseguite usando l'operatore project .The following example shows several kinds of manipulations that can be done using the project operator. La tabella di input T include tre colonne di tipo int: A, B e C.The input table T has three columns of type int: A, B, and C.

T
| project
    X=C,                       // Rename column C to X
    A=2*B,                     // Calculate a new column A from the old B
    C=strcat("-",tostring(C)), // Calculate a new column C from the old C
    B=2*B                      // Calculate a new column B from the old B

series_stats è un esempio di una funzione che restituisce più colonne.series_stats is an example of a function that returns multiple columns.