Operador project
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Selecciona las columnas que desea incluir, cambia el nombre o elimina e inserta 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 , EventId
State
EventType
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 |
... | ... |