Lenguaje de consulta Kusto para Azure Resource Graph: guía para principiantes

By Mirko Peters · 2026-10-21

Domina el lenguaje de consulta Kusto (KQL) para Azure Resource Graph. Aprende una sintaxis sencilla, filtros en cadena, operadores de tubería y consultas para gestionar tu entorno en la nube.

Automatically translated with AI from the original post. Read the English original

Dominar el lenguaje de consulta Kusto (KQL) para Azure Resource Graph permite a los administradores de la nube escribir consultas limpias y muy rápidas que muestran con facilidad el inventario de la nube, los riesgos de seguridad y el cumplimiento de gobernanza en varias suscripciones, sin depender de clics manuales en el portal.

Puntos clave

• Las consultas KQL se leen como una receta: usan el carácter de tubería (|) para encadenar pasos de procesamiento de datos secuenciales.
• La tabla predeterminada 'resources' contiene la mayor parte de lo que necesitas para consultar varias suscripciones de Azure a la vez.
• Los operadores project y extend te ayudan a limpiar resultados desordenados y a extraer valores de propiedades anidadas sin código innecesario.
• Resource Graph limita los resultados a 1,000 registros de forma predeterminada como medida de protección, por lo que en entornos muy grandes necesitarás tokens de paginación.
• Las habilidades de KQL que aprendes en Azure Resource Graph se transfieren directamente a Log Analytics y Azure Data Explorer.

Desmitificando KQL en Azure Resource Graph

Al encontrarte por primera vez con el lenguaje de consulta Kusto (KQL), la sigla puede parecer intimidante. Sin embargo, si quitas la jerga técnica, descubres una sintaxis muy accesible y parecida al inglés, diseñada para que consultar infraestructura en la nube sea intuitivo. A diferencia de escribir aplicaciones complejas o scripts pesados, KQL se centra en hacer preguntas y recuperar datos estructurados.

Cada pregunta que haces en Azure Resource Graph se construye con KQL. Si alguna vez has usado Azure Data Explorer o Log Analytics, esta sintaxis te resultará familiar de inmediato. Y aunque partas de cero, la curva de aprendizaje es sorprendentemente suave. Puedes aprender el núcleo de KQL necesario para la gestión diaria de la nube en una sola sesión.

Anatomía de una consulta KQL

Una consulta KQL se lee como una receta paso a paso. El secreto de esta legibilidad es el carácter de tubería (|), que separa cada instrucción. Partes de una tabla base de datos y luego la encadenas con comandos posteriores que reducen, filtran o reestructuran el resultado.

Lee una consulta KQL de arriba abajo y sonará casi como inglés natural. Por ejemplo, considera la consulta útil más sencilla que puedes escribir:

resources | summarize count

Dicho en voz alta, este comando equivale a: toma todo lo de la tabla predeterminada resources y dame un recuento. El sistema responde con un único número muy valioso que representa la escala total de tu patrimonio en la nube.

Operadores esenciales para administradores de la nube

Una vez que domines contar tus activos, querrás filtrar y dar formato a los datos. Algunos operadores fundamentales hacen el trabajo pesado en casi todas las consultas administrativas:

• where: filtra tu conjunto de datos según condiciones específicas. Por ejemplo, si cambias tu consulta a resources | where type == "Microsoft.Compute/virtualMachines", el recuento se limitará estrictamente a las máquinas virtuales.
• project: elige qué columnas específicas aparecen en el resultado final, lo que te permite mostrar solo el nombre del recurso, la ubicación y el identificador de la suscripción en lugar de un enorme volumen de datos JSON sin procesar.
• order by: ordena tus resultados alfabética o numéricamente, convirtiendo un volcado de datos desordenado en una tabla ordenada y fácil de revisar.
• extend: Crea una columna personalizada temporal que te permite extraer valores de configuración muy anidados y asignarles etiquetas cortas y reutilizables.

Evitar errores comunes de KQL

Aunque KQL es tolerante en algunos aspectos, tiene reglas estrictas en cuanto a mayúsculas y minúsculas. El operador de coincidencia sin distinción de mayúsculas (escrito como un signo igual seguido de una tilde, como =~) ignora sin problemas la capitalización cuando buscas valores de cadena, como tipos de recurso. Sin embargo, los nombres de propiedad son otra cosa. Si escribes mal un nombre de propiedad o usas mayúsculas incorrectas, KQL no mostrará un error de sintaxis evidente; en su lugar, devolverá valores en blanco en silencio, y te quedarás buscando un error que no existe en tu lógica.

Aprovechar las tablas más allá de lo básico

Aunque la tabla resources cubre la mayoría de las comprobaciones administrativas del día a día, existen tablas especializadas para trabajos de gobierno más profundos. Cuando necesites auditar posturas de seguridad, revisar asignaciones de directivas o inspeccionar tus contenedores organizativos, como grupos de administración, suscripciones y grupos de recursos, puedes dirigir tus consultas KQL directamente a estas tablas dedicadas.

Como KQL es un estándar transversal dentro del ecosistema de Microsoft, dominar estos patrones supone un multiplicador profesional inmediato. Las consultas que escribas hoy para limpiar grupos de seguridad de red huérfanos o identificar máquinas virtuales sin etiquetas te servirán igual de bien al redactar alertas de seguridad en Microsoft Defender o al crear paneles operativos en Log Analytics.

Conclusión y próximos pasos

Aprender Kusto Query Language convierte Azure Resource Graph de un motor oscuro en segundo plano en tu herramienta favorita para la gestión diaria de la nube. Al sustituir los tediosos clics en el portal y los scripts frágiles por consultas concisas y legibles, obtienes visibilidad total sobre tu entorno con varias suscripciones.

Para profundizar en cómo simplificar tus flujos de trabajo de administración en la nube, escucha el episodio completo para obtener más información de expertos, ejemplos prácticos y una guía práctica para aprovechar Azure Resource Graph en tu organización.

Preguntas frecuentes

¿Qué es KQL y por qué se usa en Azure Resource Graph?

KQL son las siglas de Kusto Query Language. Es un lenguaje de consulta ligero e intuitivo que se utiliza para hacer preguntas sobre tu entorno de Azure en Resource Graph. Permite filtrar, ordenar y agrupar miles de recursos en la nube al instante, mediante una sintaxis legible basada en barras verticales (pipes).

¿Cómo filtro recursos por tipo con KQL?

Puedes filtrar recursos añadiendo una cláusula 'where' después de la declaración inicial de la tabla. Por ejemplo, al escribir 'resources | where type =~ "microsoft.keyvault/vaults"' se devolverán únicamente tus almacenes de claves de Azure.

¿Por qué mi consulta KQL devuelve valores en blanco en lugar de un error?

Los nombres de propiedad en KQL distinguen entre mayúsculas y minúsculas. Si escribes mal la capitalización de un nombre de propiedad, Azure Resource Graph no mostrará un error de sintaxis; en su lugar, devolverá valores en blanco sin avisar, lo que dificulta la depuración.

¿Qué es el límite de 1.000 registros en Azure Resource Graph?

De forma predeterminada, una consulta de Resource Graph devuelve un máximo de 1.000 registros para evitar que los usuarios descarguen accidentalmente conjuntos de datos masivos. Puedes superar este límite o paginar los resultados mediante tokens de continuación si tu entorno contiene miles de recursos.