Partilhar via

Operador do projeto

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Selecione as colunas a serem incluídas, renomeadas ou descartadas e insira novas colunas computadas.

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

Sintaxe

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

quer

T| projectColumnName [=Expressão] [, ...]

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação 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 para aparecer na saída.
Expressão string A expressão escalar a ser executada sobre a entrada.
  • Deve ser especificada ColumnName ou Expression.
  • Se não houver nenhum de expressão, uma coluna de ColumnName deverá aparecer na entrada.
  • Se ColumnName for omitida, o nome da coluna de saída de Expression será gerado automaticamente.
  • Se Expressão retornar mais de uma coluna, uma lista de nomes de colunas poderá ser especificada entre parênteses. Se uma lista dos nomes das colunas não for especificada, todas as colunas de saída do Expressioncom 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.

Devoluções

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

Exemplos

Os exemplos nesta seção mostram como usar a sintaxe para ajudá-lo a começar.

Os exemplos neste artigo usam tabelas disponíveis publicamente no de cluster de ajuda, como a tabela StormEvents no banco de dados Samples.

Os exemplos neste artigo usam tabelas disponíveis publicamente, como a tabela StormEvents na análise do tempo dados de exemplo.

Mostrar apenas colunas específicas

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

StormEvents
| project EventId, State, EventType

Output

A tabela mostra os primeiros 10 resultados.

ID do Evento Estado Tipo de Evento
61032 ATLÂNTICO SUL Tromba d'água
60904 FLÓRIDA Chuva forte
60913 FLÓRIDA Tornado
64588 GEÓRGIA Vento Trovoada
68796 MISSISSIPPI Vento Trovoada
68814 MISSISSIPPI Tornado
68834 MISSISSIPPI Vento Trovoada
68846 MISSISSIPPI Salve
73241 SAMOA AMERICANA Inundação repentina
64725 KENTUCKY Inundação
... ... ...

Manipulações potenciais usando o projeto

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

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

Output

A tabela mostra os primeiros 10 resultados.

InícioLocalização Total de Lesões
LÍDIA 15
REAL 15
GOTEMBURGO 9
PLANÍCIES 8
KNOXVILLE 9
CÓRREGO CAROL 11
AZEVINHO 9
RUFFIN 9
EMPRESA MUNI ARPT 50
COLLIERVILLE 6
... ...

Conteúdo relacionado