Operador project

  • Artículo

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.

Syntax

T| project [ColumnName | (ColumnName[,])=] Expresión [, ...]

o

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

Más información sobre las convenciones de sintaxis.

Parámetros

Nombre Tipo Requerido 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 sobre 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 la 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 , EventIdState, EventType de la StormEvents tabla.

Ejecución de la consulta

StormEvents
| project EventId, State, EventType

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

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

Ejecución de la consulta

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

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

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

Contenido relacionado