Visualización de datos desde Azure Data Explorer en Redash

Redash se conecta a los orígenes de datos y los consulta, y crea paneles para visualizar datos y compartirlos con los emparejamientos. En este artículo, aprenderá a configurar Azure Data Explorer como origen de datos de Redash y luego a visualizar datos.

Prerrequisitos

Configuración del origen de datos

Realice los pasos siguientes para configurar Azure Data Explorer como origen de datos para la herramienta de panel. Trataremos estos pasos con más detalle en esta sección:

  1. Cree una entidad de servicio Microsoft Entra. La herramienta de panel usa la entidad de servicio para acceder al servicio de Azure Data Explorer.

  2. Agregue la entidad de servicio Microsoft Entra al rol visores en la base de datos de Azure Data Explorer.

  3. Especifique las propiedades de conexión de la herramienta de panel en función de la información de la entidad de servicio Microsoft Entra y pruebe la conexión.

Creación de una entidad de servicio

Puede crear la entidad de servicio en Azure Portal o mediante la experiencia de línea de comandos de la CLI de Azure. Independientemente del método que utilice, después de crear la entidad, obtendrá los valores de cuatro propiedades de conexión que usará en pasos posteriores.

Portal de Azure

  1. Para crear la entidad de servicio, siga las instrucciones de la documentación de Azure Portal.

    1. En la sección Asignación de la aplicación a un rol, asigne un tipo de rol de lector al clúster de Azure Data Explorer.

    2. En la sección Obtención de valores para iniciar sesión, copie los tres valores de propiedad indicados en los pasos: Id. de directorio (Id. de inquilino), Id. de aplicación y Contraseña.

  2. En Azure Portal, seleccione Suscripciones y copie el identificador de la suscripción en la que creó la entidad de servicio.

    Id. de suscripción (Azure Portal).

Azure CLI

  1. Crear una entidad de servicio. Establezca un ámbito adecuado y un tipo de rol de reader.

    az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                             --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
    

    Para más información, vea Creación de una entidad de servicio de Azure con la CLI de Azure.

  2. El comando devuelve un conjunto de resultados similar al siguiente. Copie los tres valores de propiedad: id_aplicación, contraseña e inquilino.

    {
      "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "displayName": "{UrlToYourDashboard}:{PortNumber}",
      "name": "https://{UrlToYourDashboard}:{PortNumber}",
      "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
    
  3. Obtenga una lista de las suscripciones.

    az account list --output table
    

    Copie el identificador de suscripción apropiado.

    Id. de suscripción (CLI).

Adición de la entidad de servicio al rol visores

Ahora que ya tiene una entidad de servicio, agréguela al rol visores en la base de datos de Azure Data Explorer. Puede realizar esta tarea en Permisos en Azure Portal o en Consulta mediante un comando de administración.

Azure Portal (Permisos)

  1. En Azure Portal, vaya al clúster de Azure Data Explorer.

  2. En la sección Introducción, seleccione la base de datos con los datos de ejemplo de StormEvents.

    Seleccione base de datos.

  3. Seleccione Permisos y luego Agregar.

    Permisos de base de datos.

  4. En Add database permissions (Agregar permisos de base de datos), seleccione el rol Visor y después Select principals (Seleccionar entidades).

    Agregar permisos de base de datos.

  5. Busque la entidad de servicio que se ha creado. Seleccione la entidad y después Seleccionar.

    Captura de pantalla del panel Nuevas entidades de seguridad de Azure Portal. Están resaltados el botón Seleccionar y dos campos con propiedades de la entidad de servicio que no se pueden descifrar.

  6. Seleccione Guardar.

    Captura de pantalla del panel Add Database Permissions (Agregar permisos de base de datos) de Azure Portal. El botón Guardar está resaltado.

Comando de administración (Consulta)

  1. En Azure Portal, vaya al clúster de Azure Data Explorer y seleccione Consulta.

    Captura de pantalla de un clúster de Azure Data Explorer en Azure Portal. Está resaltado el elemento Consulta.

  2. Ejecute el comando siguiente en la ventana de consulta. Use el identificador de la aplicación y el identificador de inquilino de Azure Portal o la CLI.

    .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
    

    El comando devuelve un conjunto de resultados similar al siguiente. En este ejemplo, la primera fila es para un usuario existente en la base de datos y la segunda fila es para la entidad de servicio que se acaba de agregar.

    Conjunto de resultados.

Creación de un conector de Azure Data Explorer en Redash

  1. Inicie sesión en Redash. Seleccione Empecemos para crear una cuenta.

  2. En Comencemos, seleccione Conectar un origen de datos.

    Conexión de un origen de datos.

  3. En la ventana Crear un nuevo origen de datos , seleccione Azure Data Explorer (Kusto) y, luego, seleccione Crear.

    Selección de un origen de datos de Azure Data Explorer.

  4. En la ventana Azure Data Explorer (Kusto), complete el siguiente formulario y seleccione Crear.

    Ventana de configuración Azure Data Explorer (Kusto).

  5. En la ventana Configuración, seleccione Guardar y Probar la conexión para probar la conexión del origen de datos de Azure Data Explorer (Kusto).

Creación de consultas en Redash

  1. En la parte superior izquierda de Redash, seleccione Crear>Consulta. Haga clic en Nueva consulta y cambie el nombre de la consulta.

    Creación de una consulta.

  2. Escriba la consulta en el panel de edición superior y seleccione Guardar y Ejecutar. Seleccione Publicar para publicar la consulta para un uso futuro.

    Almacenamiento y ejecución de la consulta.

    En el panel izquierdo, puede ver el nombre de la conexión del origen de datos (conector de github en el flujo) en el menú desplegable y las tablas de la base de datos seleccionada.

  3. Vea los resultados de la consulta en el panel central inferior. Cree una visualización para ir con la consulta seleccionando el botón Nueva visualización.

    Nueva visualización.

  4. En la pantalla de visualización, seleccione una opción en Tipo de visualización y los campos pertinentes como Columna X y Columna y. Guarde la visualización.

    Configuración y almacenamiento de la visualización.

Creación de una consulta mediante un parámetro

  1. Seleccione Crear>Consulta para crear una nueva consulta. Agregue un parámetro a ella mediante llaves {{}}. Seleccione {{}} para abrir la ventana Agregar parámetro. También puede seleccionar el icono de configuración para modificar los atributos de un parámetro existente y abrir la ventana <parameter_name>.

    Inserción del parámetro.

  2. Asigne un nombre al parámetro. Seleccione Type: Query Based Dropdown List (Tipo: Lista desplegable basada en consultas) del menú desplegable. Seleccione Aceptar.

    Lista desplegable basada en consultas.

    Nota

    La consulta utiliza varios valores, por lo que debe incluir la sintaxis | where Type in ((split('{{Type}}', ','))). Para más información, vea el operador in. Esto da como resultado varias opciones de parámetro de consulta en la aplicación de Redash.

Creación de un panel en Redash

  1. Para crear un panel, seleccione Crear>Panel. Como alternativa, seleccione el panel existente, Paneles> seleccione un panel de la lista.

    Crear panel.

  2. En ventana Nuevo panel, asigne un nombre al panel y seleccione Guardar. En la ventana <Dashboard_name>, seleccione Agregar widget para crear un nuevo widget.

  3. En la ventana Agregar widget, seleccione el nombre de la consulta, Choose Visualization (Elegir visualización) y Parámetros. Seleccione Agregar al panel.

    Elección de visualizaciones e incorporación al panel.

  4. Seleccione Edición finalizada para completar la creación del panel.

  5. En el modo de edición del panel, seleccione Use Dashboard Level Filters (Usar filtros de nivel de panel) para usar el parámetro Tipo definido previamente.

    Finalización de la creación del panel.