operador project

  • Artigo

Selecione as colunas a serem incluídas, renomeadas ou removidas e insira novas colunas calculadas.

A ordem das colunas no resultado é especificada pela ordem dos argumentos. Somente as colunas especificadas nos argumentos são incluídas no resultado. Todas as outras colunas na entrada são removidas.

Syntax

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

ou

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
T string ✔️ A entrada tabular para a qual projetar determinadas colunas.
ColumnName string Um nome de coluna ou uma lista separada por vírgulas de nomes de coluna a serem exibidos na saída.
Expression string A expressão escalar a ser executada na entrada.
  • ColumnName ou Expression devem ser especificados.
  • Se não houver Nenhuma Expressão, uma coluna de ColumnName deverá aparecer na entrada.
  • Se ColumnName for omitido, o nome da coluna de saída de Expression será gerado automaticamente.
  • Se Expression retornar mais de uma coluna, uma lista de nomes de coluna poderá ser especificada entre parênteses. Se uma lista de nomes de coluna não for especificada, todas as colunas de saída da Expressão com nomes gerados serão adicionadas à saída.

Observação

Não é recomendável retornar uma nova coluna calculada com o mesmo nome de uma coluna existente na entrada.

Retornos

Uma tabela com colunas que foram nomeadas como argumentos. Contém o mesmo número de linhas que a tabela de entrada.

Exemplos

Mostrar apenas colunas específicas

Mostrar apenas o EventId, State, EventType da StormEvents tabela.

Executar a consulta

StormEvents
| project EventId, State, EventType

A tabela de resultados a seguir mostra apenas os 10 principais resultados.

EventId Estado EventType
61032 ATLÂNTICO SUL Tromba de água
60904 FLÓRIDA Chuva Forte
60913 FLÓRIDA Tornado
64588 GEÓRGIA Thunderstorm Wind
68796 MISSISSIPI Thunderstorm Wind
68814 MISSISSIPI Tornado
68834 MISSISSIPI Thunderstorm Wind
68846 MISSISSIPI Granizo
73241 SAMOA AMERICANA Saturação de Flash
64725 KENTUCKY Saturação
... ... ...

Possíveis manipulações usando o projeto

A consulta a seguir renomeia a BeginLocation coluna e cria uma nova coluna chamada TotalInjuries de um cálculo em duas colunas existentes.

Executar a consulta

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

A tabela a seguir mostra apenas os primeiros 10 resultados.

StartLocation TotalInjuries
LYDIA 15
REAL 15
GOTEMBURGO 9
PLANÍCIES 8
KNOXVILLE 9
CAROL STREAM 11
HOLLY 9
RUFFIN 9
ENTERPRISE MUNI ARPT 50
COLLIERVILLE 6
... ...

Conteúdo relacionado