operador projectproject operator

Selecione as colunas para incluir, renomear ou largar e inserir novas colunas computadas.Select the columns to include, rename or drop, and insert new computed columns.

A ordem das colunas no resultado é especificada pela ordem dos argumentos.The order of the columns in the result is specified by the order of the arguments. Apenas as colunas especificadas nos argumentos estão incluídas no resultado.Only the columns specified in the arguments are included in the result. Quaisquer outras colunas na entrada são largadas.Any other columns in the input are dropped. (Ver também extend .)(See also extend.)

T | project cost=price*quantity, price

SyntaxSyntax

T | project ColumnName [ = Expressão] [ , ...]T | project ColumnName [= Expression] [, ...]

ouor

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

ArgumentosArguments

  • T: A tabela de entrada.T: The input table.

  • Nome da coluna: Nome opcional de uma coluna a aparecer na saída.ColumnName: Optional name of a column to appear in the output. Se não houver Expressão, então o Nome da Coluna é obrigatório e uma coluna desse nome deve aparecer na entrada.If there is no Expression, then ColumnName is mandatory and a column of that name must appear in the input. Se omitido, o nome será gerado automaticamente.If omitted, the name will be automatically generated. Se a expressão retornar mais do que uma coluna, uma lista de nomes de colunas pode ser especificada em parênteses.If Expression returns more than one column, a list of column names can be specified in parentheses. Neste caso, as colunas de saída da Expression receberão os nomes especificados, largando todo o resto das colunas de saída, se existirem.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 a lista dos nomes das colunas não for especificada, todas as colunas de saída da Expressão com nomes gerados serão adicionadas à saída.If list of the column names is not specified, all Expression's output columns with generated names will be added to the output.

  • Expressão: Expressão de escala opcional referente às colunas de entrada.Expression: Optional scalar expression referencing the input columns. Se o Nome da Coluna não for omitido, a expressão é obrigatória.If ColumnName is not omitted then Expression is mandatory.

    É legal devolver uma nova coluna calculada com o mesmo nome que uma coluna existente na entrada.It is legal to return a new calculated column with the same name as an existing column in the input.

DevoluçõesReturns

Uma tabela que tem as colunas nomeadas como argumentos, e tantas linhas como a tabela de entrada.A table that has the columns named as arguments, and as many rows as the input table.

ExemploExample

O exemplo a seguir mostra vários tipos de manipulações que podem ser feitas com o project operador.The following example shows several kinds of manipulations that can be done using the project operator. A tabela de entrada T tem três colunas do int tipo: , e A B 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 é um exemplo de uma função que devolve várias colunas.series_stats is an example of a function that returns multiple columns.