Inicio rápido: Ejecución de consultas de Resource Graph mediante Azure Portal

Artículo
04/26/2024

En este inicio rápido se describe cómo ejecutar una consulta de Azure Resource Graph en Azure Portal mediante el Explorador de Azure Resource Graph. Resource Graph Explorer permite consultar información sobre los tipos de recursos Azure Resource Manager y las propiedades. Resource Graph Explorer también proporciona una interfaz para trabajar con varias consultas, evaluar los resultados e incluso convertir los de algunas consultas en un gráfico que se puede anclar a un panel de Azure.

Requisitos previos

Antes de comenzar, si no tiene una cuenta de Azure, cree una gratuita.

Ejecución de una consulta

Ejecute una consulta desde Azure Portal mediante el Explorador de Azure Resource Graph.

Inicie sesión en Azure Portal.
Busque el gráfico de recursos y seleccione Resource Graph Explorer.
Si necesita cambiar el ámbito, seleccione Directorio. A continuación, seleccione el directorio, el grupo de administración o la suscripción para los recursos que desea consultar.
En la parte Consulta 1 de la ventana, copie y pegue la siguiente consulta. Después, seleccione Ejecutar consulta.
```
resources
| project name, type
| limit 5
```
En este ejemplo de consulta no se proporciona un modificador de ordenación como order by. Si ejecuta la consulta varias veces, puede producir un conjunto diferente de recursos para cada solicitud.
Revise la respuesta de consulta en la pestaña Resultados y seleccione la pestaña Mensajes para ver los detalles de la consulta, incluido el número de resultados y la duración. Los errores, si los hay, se muestran en la pestaña Mensajes.
Actualice la consulta para order by la namepropiedad. Posteriormente, seleccione Ejecutar consulta
```
resources
| project name, type
| limit 5
| order by name asc
```
Al igual que la consulta anterior, ejecutar esta consulta varias veces podría producir un conjunto diferente de recursos para cada solicitud. El orden de los comandos de consulta es importante. En este ejemplo, el order by viene después del limit. La consulta limita los resultados a cinco recursos y, a continuación, ordena esos resultados por nombre.
Actualice la consulta para order by la namepropiedad y, a continuación, limit a los cinco primeros resultados. Luego, seleccione Ejecutar consulta.
```
resources
| project name, type
| order by name asc
| limit 5
```
Si esta consulta se ejecuta varias veces sin cambios en el entorno, los resultados son coherentes y ordenados por la propiedad name, pero todavía están limitados a cinco resultados. La consulta ordena los resultados por nombre y, a continuación, limita la salida a cinco recursos.

Explorador de esquema

El explorador de esquema se encuentra en el panel izquierdo de Resource Graph Explorer. En esta lista de recursos se muestran todos los tipos de recursos de Azure que son compatibles con Azure Resource Graph y que existen en su inquilino. Seleccione un tipo de recurso o la propiedad para que se muestren las propiedades secundarias que se pueden usar para crear una consulta de Resource Graph.

Seleccione un nombre de tabla en el explorador de esquemas y se agregará a la consulta. Al seleccionar un tipo de recurso, se agrega a la consulta, como where type =="<resource type>". Si selecciona una propiedad, se agrega a la siguiente línea de la consulta, como where <propertyName> == "INSERT_VALUE_HERE". Puede usar el explorador de esquemas para buscar propiedades que puede usar en las consultas. Asegúrese de reemplazar INSERT_VALUE_HERE por su propio valor y ajuste la consulta con condiciones, operadores y funciones.

En este ejemplo se muestra una consulta compilada desde el explorador de esquemas seleccionando la tabla authorizationresources con el tipo de recurso microsoft.authorization/roledefinitions y la propiedad roleName.

authorizationresources
| where type == "microsoft.authorization/roledefinitions"
| where properties['roleName'] == "INSERT_VALUE_HERE"

Descarga de los resultados de la consulta como un archivo CSV

Para descargar los resultados de valores separados por comas (CSV) de Azure Portal, vaya a Azure Resource Graph Explorer y ejecute una consulta. En la barra de herramientas, seleccione Descargar como CSV, como se muestra en la captura de pantalla siguiente:

Al usar la funcionalidad de exportación Descargar como CSV de Azure Resource Graph Explorer, el conjunto de resultados se limita a 55 000 registros. Se trata de una limitación de la plataforma que no se puede invalidar mediante la presentación de una incidencia de Soporte técnico de Azure.

Creación de un gráfico a partir de los resultados de la consulta

Puede crear gráficos a partir de consultas que generen un recuento para el número de recursos. Las consultas que las listas de salida no se pueden realizar en un gráfico. Si intenta crear un gráfico a partir de una lista, un mensaje como el conjunto de resultados no es compatible con una visualización de gráfico de anillos se muestra en la pestaña Gráficos.

Para crear un gráfico a partir de los resultados de la consulta, siga estos pasos:

En la parte Consulta 1 de la ventana, escriba la siguiente consulta y seleccione Ejecutar consulta.

resources
| where type == "microsoft.compute/virtualmachines"
| summarize count() by tostring(properties.storageProfile.osDisk.osType)

Seleccione la pestaña Resultados y observe que en la respuesta de esta consulta se proporcionan recuentos.
Seleccione la pestaña Gráficos. Cambie el tipo de Seleccionar tipo de gráfico... a Gráfico de barras o Gráfico de anillos.

Anclar la visualización de consultas al panel

Si tiene resultados de una consulta que se pueden visualizar, esa visualización de datos se puede anclar al panel de Azure Portal. Después de ejecutar la consulta anterior, siga estos pasos:

Seleccione Guardar y use el nombre máquina virtual por tipo de sistema operativo y escriba como Consultas privadas. Luego, seleccione Guardar en la parte inferior del panel derecho.
Seleccione Ejecutar consulta para volver a probar la consulta que ha creado.
En la pestaña Gráficos, seleccione una visualización de datos. Seleccione Anclar al panel.
En Anclar al panel seleccione el panel existente en el que desea que aparezca el gráfico.
Seleccione Panel en el menú de tres líneas horizontales en la parte superior izquierda de cualquier página del portal.

La consulta ya está disponible en el panel con el título Máquina virtual por tipo de sistema operativo. Si la consulta no se guardó antes de anclarla, el nombre será Consulta 1, alternativamente.

La consulta y la visualización de datos resultante se ejecutan y actualizan cada vez que se carga el panel, de forma que se proporcionan conclusiones dinámicas y en tiempo real al entorno de Azure directamente en el flujo de trabajo.

Las consultas que dan como resultado una lista también se pueden anclar al panel. La característica no está limitada a las visualizaciones de datos de las consultas.

Cuando se ejecuta una consulta desde el portal, puede seleccionar Directorio para cambiar el ámbito de la consulta para el directorio, el grupo de administración o la suscripción de los recursos que desea consultar. Cuando se selecciona Anclar al panel, los resultados se agregan al panel de Azure con el ámbito usado cuando se ejecutó la consulta.

Para obtener más información sobre cómo trabajar con paneles, consulte Creación de un panel en Azure Portal.

Limpieza de recursos

Si quiere quitar los paneles de ejemplo de Resource Graph del entorno de Azure Portal, lleve a cabo los pasos siguientes:

Seleccione Panel en el menú de tres líneas horizontales en la parte superior izquierda de cualquier página del portal.
En el panel, busque el gráfico Máquina virtual por tipo de sistema operativo y seleccione los puntos suspensivos (...) para mostrar el menú.
Seleccione Quitar del panel y Guardar para confirmar.

Si desea eliminar consultas guardadas, como Máquina virtual por tipo de sistema operativo, siga estos pasos:

Vaya al Explorador de Azure Resource Graph.
Seleccione Abrir una consulta.
Seleccione Tipo Consultas privadas.
En Nombre de consulta seleccione el icono de cubo de basura para Eliminar esta consulta.
Seleccione Sí para confirmar la eliminación.

Pasos siguientes

En este inicio rápido, ha usado el Explorador de Azure Resource Graph para ejecutar una consulta y ha revisado cómo usar gráficos y paneles. Para más información, vaya al artículo de detalles del lenguaje de consulta.

Información del lenguaje de consulta de Azure Resource Graph

Compartir vía