operador project

  • Artigo

Selecione as colunas a incluir, mudar o nome ou largar e inserir novas colunas calculadas.

A ordem das colunas no resultado é especificada pela ordem dos argumentos. Apenas as colunas especificadas nos argumentos estão incluídas no resultado. Quaisquer 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 Necessá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 colunas a aparecer na saída.
Expression string A expressão escalar a executar através da entrada.
  • ColumnName ou Expression têm de ser especificados.
  • Se não existir Expressão, tem de aparecer uma coluna de ColumnName na entrada.
  • Se ColumnName for omitido, o nome da coluna de saída de Expressão será gerado automaticamente.
  • Se a Expressão devolver mais do que uma coluna, pode ser especificada uma lista de nomes de colunas em parênteses. Se não for especificada uma lista dos nomes das colunas, todas as colunas de saída da Expressão com nomes gerados serão adicionadas à saída.

Nota

Não é recomendado devolver uma nova coluna calculada com o mesmo nome que uma coluna existente na entrada.

Devoluções

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

Exemplos

Mostrar apenas colunas específicas

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

Executar a consulta

StormEvents
| project EventId, State, EventType

A tabela de resultados seguinte mostra apenas os 10 melhores resultados.

EventId Estado EventType
61032 SUL DO ATLÂNTICO Waterspout
60904 FLORIDA Chuva Intensa
60913 FLORIDA Tornado
64588 GEÓRGIA Vento trovoada
68796 MISSISSIPPI Vento trovoada
68814 MISSISSIPPI Tornado
68834 MISSISSIPPI Vento trovoada
68846 MISSISSIPPI Granizo
73241 SAMOA AMERICANA Inundação Repentina
64725 KENTUCKY Inundação
... ... ...

Potenciais manipulações com o projeto

A consulta seguinte muda o nome da BeginLocation coluna e cria uma nova coluna chamada TotalInjuries a partir de um cálculo em duas colunas existentes.

Executar a consulta

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

A tabela seguinte 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