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
Los ejemplos de esta sección muestran cómo usar la sintaxis para ayudarle a empezar.
En los ejemplos de este artículo se usan tablas disponibles públicamente en el clúster de , como la tabla
StormEvents
de la base de datos ejemplos de.
En los ejemplos de este artículo se usan tablas disponibles públicamente, como la tabla
StormEvents
del análisis meteorológico datos de ejemplo.
Mostrar solo columnas específicas
Solo muestra , EventId
State
EventType
de la StormEvents
tabla.
StormEvents
| project EventId, State, EventType
de salida
En la tabla se muestran los primeros 10 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
de salida
En la tabla 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 |
... | ... |