Compartir a través de


Operador de proyecto

Cambie los servicios mediante la lista desplegable Versión . Más información sobre la navegación.
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.

Syntax

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

or

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

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

Parameters

Name Type Required Description
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.

Note

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

Returns

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

Examples

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 ayuda, como la StormEvents tabla de la base de datos samples .

En los ejemplos de este artículo se usan tablas disponibles públicamente, como la Weather tabla de la galería de ejemplos de Análisis meteorológicos. Es posible que tenga que modificar el nombre de la tabla en la consulta de ejemplo para que coincida con la tabla del área de trabajo.

Mostrar solo columnas específicas

Solo muestra , EventIdStateEventType de la StormEvents tabla.

StormEvents
| project EventId, State, EventType

Output

En la tabla se muestran los primeros 10 resultados.

EventId State EventType
61032 ATLÁNTICO SUR Waterspout
60904 FLORIDA Lluvia intensa
60913 FLORIDA Tornado
64588 GEORGIA Viento de tormenta
68796 MISSISSIPPI Viento de tormenta
68814 MISSISSIPPI Tornado
68834 MISSISSIPPI Viento de tormenta
68846 MISSISSIPPI Hail
73241 SAMOA AMERICANA Riada
64725 KENTUCKY Flood
... ... ...

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

Output

En la tabla se muestran los primeros 10 resultados.

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