Compartir a través de


Operador project

Seleccione las columnas que se incluirán, cambie el nombre o quite e inserte nuevas columnas calculadas.

El orden de las columnas en el resultado se especifica con el orden de los argumentos. Solamente las columnas especificadas en los argumentos se incluyen en el resultado. Todas las demás columnas de la entrada se quitan.

Sintaxis

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

o

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

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
T string ✔️ Entrada tabular para la que se proyectan determinadas columnas.
ColumnName string Nombre de columna o lista separada por comas de nombres de columna que aparecerán en la salida.
Expression string Expresión escalar que se va a realizar a través de la entrada.
  • Se debe especificar ColumnName o Expression .
  • Si no hay ninguna expresión, debe aparecer una columna de ColumnName en la entrada.
  • Si se omite ColumnName , el nombre de columna de salida de Expression se generará automáticamente.
  • Si Expression devuelve más de una columna, se puede especificar una lista de nombres de columna entre paréntesis. Si no se especifica una lista de los nombres de columna, todas las columnas de salida de Expression con nombres generados se agregarán a la salida.

Nota:

No se recomienda devolver una nueva columna calculada con el mismo nombre que una columna existente en la entrada.

Devoluciones

Tabla con columnas denominadas como argumentos. Contiene el mismo número de filas que la tabla de entrada.

Ejemplos

Mostrar solo columnas específicas

Solo muestra , EventIdStateEventType de la StormEvents tabla.

StormEvents
| project EventId, State, EventType

En la tabla de resultados siguiente solo se muestran los 10 primeros resultados.

EventId State EventType
61032 ATLÁNTICO SUR Tromba de agua
60904 FLORIDA Lluvia intensa
60913 FLORIDA Tornado
64588 GEORGIA Viento de tormenta
68796 MISISIPÍ Viento de tormenta
68814 MISISIPÍ Tornado
68834 MISISIPÍ Viento de tormenta
68846 MISISIPÍ Granizo
73241 AMERICAN SAMOA Riada
64725 KENTUCKY Inundación
... ... ...

Posibles manipulaciones mediante el proyecto

La consulta siguiente cambia el nombre de la BeginLocation columna y crea una nueva columna llamada TotalInjuries a partir de un cálculo en dos columnas existentes.

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

En la tabla siguiente solo se muestran los primeros 10 resultados.

StartLocation TotalInjuries
LIDIA 15
REAL 15
GOTEMBURGO 9
LLANURAS 8
KNOXVILLE 9
CAROL STREAM 11
ACEBO 9
RUFFIN 9
ENTERPRISE MUNI ARPT 50
COLLIERVILLE 6
... ...