operador project
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft 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
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 exemplos de.
Os exemplos neste artigo usam tabelas disponíveis publicamente, como a tabela
StormEvents
na análise de clima dados de exemplo.
Mostrar apenas colunas específicas
Mostre apenas o EventId
, State
, EventType
da StormEvents
tabela.
StormEvents
| project EventId, State, EventType
de saída
A tabela mostra os primeiros 10 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
de saída
A tabela mostra 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 |
... | ... |