Compartilhar via


operador project

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Selecione as colunas a serem incluídas, renomear ou descartar e inserir novas colunas computadas.

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.

Sintaxe

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

ou

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória 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.
Expressão string A expressão escalar a ser executada sobre a entrada.
  • ColumnName ou Expression devem ser especificados.
  • Se não houver Expression, 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.

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

Mostrar apenas colunas específicas

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

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 AMERICAN SAMOA Saturação de Flash
64725 KENTUCKY Saturação
... ... ...

Manipulações potenciais 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.

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

A tabela a seguir mostra apenas os primeiros 10 resultados.

Localização inicial TotalLesões
LÍDIA 15
REAL 15
GOTEMBURGO 9
PLANÍCIE 8
KNOXVILLE 9
CÓRREGO DE CAROL 11
AZEVINHO 9
RUFFIN 9
EMPRESA MUNI ARPT 50
COLLIERVILLE 6
... ...