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
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 |
... | ... |