Cómo seleccionar columnas con project en KQL: ejemplo

El operador project es una de las herramientas más usadas en KQL (Kusto Query Language) cuando necesitas seleccionar columnas: permite elegir exactamente qué columnas aparecen en el resultado, cambiar su orden y renombrarlas. Saber usar project deja las consultas más limpias, más fáciles de leer y más rápidas, porque la consulta solo transporta los datos que realmente necesitas.

Requisitos previos

• Acceso a un entorno con KQL: una base de datos KQL o Eventhouse en Microsoft Fabric, un clúster de Azure Data Explorer, o el clúster de demostración público help.
• Saber abrir el editor de consultas y ejecutar una consulta sencilla.
• No necesitas datos propios: los ejemplos crean una tabla de muestra con el operador datatable.

Paso 1: Crear datos de muestra con datatable

Para seguir los ejemplos sin depender de ninguna tabla existente, vamos a crear una pequeña tabla de ventas dentro de la propia consulta, con el operador datatable. Copia este bloque en el editor y ejecútalo:

let Vendas = datatable(DataVenda:datetime, Produto:string, Regiao:string, Quantidade:int, PrecoUnitario:real)
[
    datetime(2026-07-01), "Teclado", "Norte",  3, 25.0,
    datetime(2026-07-01), "Rato",    "Sul",    5, 12.5,
    datetime(2026-07-02), "Monitor", "Norte",  2, 149.9,
    datetime(2026-07-02), "Teclado", "Centro", 4, 25.0
];
Vendas

Al ejecutarlo, deberías ver cuatro filas y cinco columnas. Esta tabla Vendas es la base de todos los pasos siguientes, así que mantén el bloque let al principio de la consulta.

Paso 2: Seleccionar columnas con project

En una tabla real suele haber decenas de columnas, pero normalmente solo necesitas algunas. Con project indicas cuáles quieres conservar, y todas las demás se descartan del resultado:

Vendas
| project Produto, Quantidade, PrecoUnitario

El resultado pasa a tener solo tres columnas. Además de facilitar la lectura, transportar menos columnas reduce el volumen de datos procesado, lo que ayuda al rendimiento y al coste en tablas grandes. Fíjate también en que el orden del resultado sigue el orden en que escribiste las columnas en project, y no el orden original de la tabla.

Paso 3: Reordenar y renombrar columnas

Como es project quien define el orden, basta con cambiar los nombres de posición para reordenar las columnas. Para renombrar, usa la sintaxis NuevoNombre = ColumnaOriginal:

Vendas
| project Regiao, Produto, Unidades = Quantidade

Ahora la columna Regiao aparece primero y Quantidade pasa a llamarse Unidades. Renombrar es muy útil para dar títulos más claros cuando el resultado va a alimentar un informe o un dashboard.

Paso 4: Crear una columna calculada dentro de project

project también acepta expresiones, así que puedes calcular valores nuevos sin necesidad de un extend aparte. Por ejemplo, el total de cada fila (cantidad por precio):

Vendas
| project Produto, Total = Quantidade * PrecoUnitario

El resultado muestra Produto y una nueva columna Total, calculada fila a fila.

Consejo: usa extend cuando quieras conservar todas las columnas y solo añadir una más; usa project cuando quieras quedarte solo con un subconjunto de columnas. Esa es la diferencia esencial entre los dos operadores.

Paso 5: Eliminar o renombrar sin listarlo todo

Cuando solo quieres quitar una o dos columnas de una tabla con muchas, listar todas las demás en project es tedioso y propenso a errores. En ese caso usa project-away, que elimina solo las columnas indicadas y conserva las otras:

Vendas
| project-away DataVenda

También existe project-keep, que hace lo contrario: conserva solo las columnas indicadas (admite patrones), útil cuando quieres quedarte con unas pocas de entre muchas. Y para renombrar sin tocar el resto de columnas, usa project-rename:

Vendas
| project-rename Preco = PrecoUnitario

Así conservas todas las columnas originales y cambias solo lo que necesitas.

Comprobar el resultado

Ejecuta cada ejemplo en el editor y comprueba en la cuadrícula de resultados el número de columnas, sus nombres y el orden: deben coincidir exactamente con lo que pediste en project. Una buena forma de probarlo es comparar el resultado de Vendas (la tabla completa) con el de Vendas | project Produto, Quantidade — en el segundo caso deberías ver menos columnas. Si una columna que esperabas ha desaparecido, comprueba que la incluiste en la lista de project, ya que todo lo que no se lista se elimina.

Conclusión

Ya sabes usar project para seleccionar, reordenar, renombrar y calcular columnas, además de project-away, project-keep y project-rename para ajustes rápidos. El siguiente paso natural es combinar project con where para filtrar filas y con summarize para agregar datos. Un último consejo de rendimiento: coloca project pronto en el pipeline, justo después de los filtros, para reducir las columnas que se transportan a lo largo de la consulta. ¿Qué columnas podría dejar de transportar tu próxima consulta?