Partilhar via

project operator

Applies to: ✅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.

Syntax

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

or

T| projectColumnName [=Expression] [, ...]

Learn more about syntax conventions.

Parameters

Name Tipo Required Description
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.
Expression string A expressão escalar a ser executada sobre a entrada.
  • Either ColumnName or Expression must be specified.
  • If there's no Expression, then a column of ColumnName must appear in the input.
  • If ColumnName is omitted, the output column name of Expression will be automatically generated.
  • If Expression returns more than one column, a list of column names can be specified in parentheses. If a list of the column names isn't specified, all Expression's output columns with generated names will be added to the output.

Note

Não é recomendável retornar uma nova coluna calculada com o mesmo nome de uma coluna existente na entrada.

Returns

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

Examples

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

The examples in this article use publicly available tables in the help cluster, such as the StormEvents table in the Samples database.

The examples in this article use publicly available tables, such as the Weather table in the Weather analytics sample gallery. Talvez seja necessário modificar o nome da tabela na consulta de exemplo para corresponder à tabela em seu espaço de trabalho.

Mostrar apenas colunas específicas

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

Executar a consulta

StormEvents
| project EventId, State, EventType

Output

A tabela mostra os primeiros 10 resultados.

EventId State EventType
61032 ATLANTIC SOUTH Waterspout
60904 FLORIDA Heavy Rain
60913 FLORIDA Tornado
64588 GEORGIA Thunderstorm Wind
68796 MISSISSIPPI Thunderstorm Wind
68814 MISSISSIPPI Tornado
68834 MISSISSIPPI Thunderstorm Wind
68846 MISSISSIPPI Hail
73241 AMERICAN SAMOA Flash Flood
64725 KENTUCKY Flood
... ... ...

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.

Executar a consulta

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

Output

A tabela mostra os primeiros 10 resultados.

StartLocation TotalInjuries
LYDIA 15
ROYAL 15
GOTHENBURG 9
PLAINS 8
KNOXVILLE 9
CAROL STREAM 11
HOLLY 9
RUFFIN 9
EMPRESA MUNI ARPT 50
COLLIERVILLE 6
... ...

Related content

  • Last updated on