Inicio rápido: Consulta de datos en la interfaz de usuario web de Azure Data Explorer

Azure Data Explorer es un servicio de análisis de datos rápido y totalmente administrado que permite analizar grandes volúmenes de datos en tiempo real. Azure Data Explorer proporciona una experiencia web que le permite conectarse a los clústeres de Azure Data Explorer y escribir, ejecutar y compartir comandos y consultas del lenguaje de consulta Kusto. La experiencia web está disponible en Azure Portal y como aplicación web independiente, la interfaz de usuario web de Azure Data Explorer. La interfaz de usuario web de Azure Data Explorer también puede hospedarse en otros portales web en un iframe de HTML. Para obtener más información sobre cómo hospedar la interfaz de usuario web y el editor Monaco usado, consulte Integración del IDE de Monaco. En esta guía de inicio rápido, trabajará en la interfaz de usuario web independiente de Azure Data Explorer.

Tutorial de la experiencia del explorador web de Kusto.

Prerrequisitos

Inicie sesión en la aplicación.

Inicie sesión en la aplicación.

Agregar clústeres

Al abrir la aplicación por primera vez, no hay ninguna conexión al clúster.

Agregar clúster.

Debe agregar una conexión a un clúster antes de poder empezar a ejecutar consultas. En esta sección, agregará conexiones al clúster ayuda de Azure Data Explorer y al clúster de prueba que creó en los Requisitos previos (opcional).

Incorporación del clúster de ayuda

  1. En la parte superior izquierda de la aplicación, seleccione Agregar clúster.

  2. En el cuadro de diálogo Agregar clúster, escriba el URI https://help.kusto.windows.net y luego seleccione Agregar.

  3. En el panel izquierdo, debería ver ahora el clúster de ayuda. Expanda la base de datos Samples y abra la carpeta Tables para ver las tablas de ejemplos a las que tiene acceso.

    Búsqueda de la tabla en el clúster de ayuda.

Usamos la tabla StormEvents posteriormente en esta guía de inicio rápido y en otros artículos del Explorador de datos de Azure.

Incorporación del clúster

Agregue ahora el clúster de prueba que creó.

  1. Seleccione Agregar clúster.

  2. En el cuadro de diálogo Agregar clúster, escriba su dirección URL del clúster de prueba en el formulario https://<ClusterName>.<Region>.kusto.windows.net/ y, luego, seleccione Agregar. Por ejemplo, https://mydataexplorercluster.westus.kusto.windows.net tal como se muestra en la siguiente imagen:

    Introducción de la dirección URL del clúster de prueba.

  3. En el siguiente ejemplo, puede ver el clúster de ayuda y un nuevo clúster, docscluster.westus (la dirección URL completa es https://docscluster.westus.kusto.windows.net/).

    Clúster de prueba.

Ejecutar consultas

Ahora puede ejecutar consultas en ambos clústeres (siempre que tenga datos en el clúster de prueba). En este artículo, nos centraremos en el clúster de ayuda.

  1. En el panel izquierdo, en el clúster de ayuda, seleccione la base de datos de ejemplo.

  2. Copie y pegue la siguiente consulta en la ventana de consulta. En la parte superior de la ventana, seleccione Examinar.

    StormEvents
    | sort by StartTime desc
    | take 10
    

    Esta consulta devuelve los 10 registros más recientes de la tabla StormEvents. El resultado debe tener un aspecto similar a la siguiente tabla.

    Captura de pantalla de una tabla que muestra los datos de 10 eventos de tormenta.

    En la siguiente imagen se muestra el estado de la aplicación, con clústeres agregados y una consulta con resultados.

    Pantalla completa.

  3. Copie y pegue la siguiente consulta en la ventana de consulta, después de la primera consulta. Como puede ver, su formato no tiene líneas independientes, como la primera consulta.

    StormEvents | sort by StartTime desc 
    | project StartTime, EndTime, State, EventType, DamageProperty, EpisodeNarrative | take 10
    
  4. Seleccione la nueva consulta. Presione Mayús+Alt+F para dar formato a la consulta de modo que tenga el aspecto de la consulta siguiente.

    Consulta con formato.

  5. Para ejecutar una consulta, seleccione Ejecutar o presione Mayús + ENTRAR. Esta consulta devuelve los mismos registros que la primera, pero incluye solo las columnas especificadas en la instrucción project. El resultado debe tener un aspecto similar a la siguiente tabla.

    Captura de una tabla en la que se enumeran la hora de inicio, la hora de finalización, el estado, el tipo de evento, la propiedad del daño y la narrativa de episodio de 10 eventos de tormenta.

    Sugerencia

    Seleccione Recuperar en la parte superior de la ventana de consulta para mostrar el conjunto de resultados de la primera consulta sin necesidad de volver a ejecutar la consulta. A menudo, durante el análisis, se ejecutan varias consultas, y Recuperar le permite recuperar los resultados de consultas anteriores.

  6. Vamos a ejecutar una consulta más para ver un tipo de resultado distinto.

    StormEvents
    | summarize event_count=count(), mid = avg(BeginLat) by State
    | sort by mid
    | where event_count > 1800
    | project State, event_count
    | render columnchart
    

    El resultado debe tener un aspecto similar al siguiente gráfico.

    Gráfico de columnas.

    Nota

    Las líneas en blanco de la expresión de consulta pueden afectar a la parte de la consulta que se ejecuta.

    • Si no hay texto seleccionado, se supone que la consulta o el comando está separado por líneas vacías.
    • Si se selecciona texto, se ejecuta el texto seleccionado.

Trabajar con la cuadrícula de tabla

Ahora que ha visto cómo funcionan las consultas básicas, puede usar la cuadrícula de tabla para personalizar los resultados y realizar más análisis.

Expansión de celdas

La posibilidad de expandir las celdas es útil para ver cadenas largas o campos dinámicos, como JSON.

  1. Haga doble clic en una celda para abrir una vista expandida. Esta vista permite leer cadenas largas y proporciona un formato JSON para los datos dinámicos.

    Celda expandida de la interfaz de usuario web de Azure Data Explorer para mostrar cadenas largas.

  2. Haga clic en el icono de la parte superior derecha de la cuadrícula de resultados para cambiar los modos del panel de lectura. Elija entre los siguientes modos del panel de lectura para la vista expandida: en línea, panel inferior y panel derecho.

    Icono para cambiar el panel de lectura en el modo de vista expandida: resultados de la consulta de la interfaz de usuario web de Azure Data Explorer.

Expansión de una fila

Cuando trabaje con tablas que tengan docenas de columnas, expanda toda la fila para tener fácilmente una visión general de las diferentes columnas y su contenido.

  1. Haga clic en la flecha > a la izquierda de la fila que desea expandir.

    Expandir una fila en la interfaz de usuario web de Azure Data Explorer.

  2. Dentro de la fila expandida, algunas columnas se expanden (flecha hacia abajo), mientras que otras se contraen (flecha hacia la derecha). Haga clic en las flechas para alternar entre estos dos modos.

Agrupación de columna por resultados

Los resultados se pueden agrupar por cualquier columna.

  1. Ejecute la siguiente consulta:

    StormEvents
    | sort by StartTime desc
    | take 10
    
  2. Coloque el mouse sobre la columna Estado, seleccione el menú y seleccione Agrupar por estado.

    Agrupar por estado.

  3. En la cuadrícula, haga doble clic en California para expandir y ver los registros de ese estado. Este tipo de agrupación puede resultar de utilidad al realizar análisis exploratorios.

    Captura de pantalla de una cuadrícula de resultados de la consulta con el grupo California expandido.

  4. Coloque el mouse sobre la columna Grupo y, a continuación, seleccione Restablecer columnas. Este valor devuelve la cuadrícula a su estado original.

    Restablecer columnas.

Uso de la agregación de valor

Después de haber agrupado por una columna, puede utilizar la función de agregación de valor para calcular estadísticas simples por grupo.

  1. Seleccione el menú de la columna que desea evaluar.

  2. Seleccione Agregación de valor y, después, seleccione el tipo de función que desea hacer en esta columna.

    Agregar resultados al agrupar columnas por resultados.

Filtrado de columnas

Puede usar uno o varios operadores para filtrar los resultados de una columna.

  1. Para filtrar una columna concreta, seleccione el menú de la misma.

  2. Seleccione el icono de filtro.

  3. En el generador de filtros, seleccione el operador que desee.

  4. Escriba la expresión por la que desea filtrar la columna. Los resultados se filtran a medida que escribe.

    Nota

    El filtro no distingue entre mayúsculas y minúsculas.

  5. Para crear un filtro de varias condiciones, seleccione un operador booleano para agregar otra condición.

  6. Para quitar el filtro, elimine el texto de la primera condición de filtro.

    GIF en el que se muestra cómo filtrar por una columna en la interfaz de usuario web de Azure Data Explorer.

Ejecución de estadísticas de celda

  1. Ejecute la siguiente consulta.

    StormEvents
    | sort by StartTime desc
    | where DamageProperty > 5000
    | project StartTime, State, EventType, DamageProperty, Source
    | take 10
    
  2. En la cuadrícula de resultados, seleccione algunas de las celdas numéricas. La cuadrícula de tabla permite seleccionar varias filas, columnas y celdas, y calcular agregaciones en ellas. La interfaz de usuario web admite actualmente las siguientes funciones para valores numéricos: Media, Recuento, Mín. , Máx. y Suma.

    selección de funciones.

Filtrado para consultar desde la cuadrícula

Otra forma fácil de filtrar la cuadrícula es agregar un operador de filtro a la consulta directamente desde la cuadrícula.

  1. Seleccione la celda con contenido para la que desea crear un filtro de consulta.

  2. Haga clic con el botón derecho para abrir el menú de acciones de la celda. Seleccione Add selection as filter (Agregar selección como filtro).

    Agregar selección como filtro para consultar desde los resultados de la cuadrícula en la interfaz de usuario web de Azure Data Explorer.

  3. Se agregará una cláusula de consulta a la consulta en el editor de consultas:

    Agregar cláusula de consulta del filtrado en la cuadrícula en la interfaz de usuario web de Azure Data Explorer.

Dinamización

La característica de modo dinámico es similar a la tabla dinámica de Excel, ya que permite realizar análisis avanzados en la propia cuadrícula.

La dinamización permite tomar el valor de una columna y convertirlo en columnas. Por ejemplo, puede dinamizar en la columna State (Estado) para crear columnas para Florida, Missouri, Alabama, etc.

  1. En el lado derecho de la cuadrícula, seleccione Columnas para ver el panel de herramientas de la tabla.

    Panel de herramientas de la tabla.

  2. Seleccione Modo de pivote y, después, arrastre las columnas de este modo: EventType a Row groups (Grupos de filas); DamageProperty a Values (Valores) y State (Estado) to Column labels (Etiquetas de columna).

    Modo dinámico.

    El resultado debe tener un aspecto similar a la siguiente tabla dinámica:

    Tabla dinámica.

Búsqueda en la tabla de resultados

Puede buscar una expresión específica dentro de una tabla de resultados.

  1. Ejecute la siguiente consulta:

    StormEvents
    | where DamageProperty > 5000
    | take 1000
    
  2. Haga clic en el botón Buscar de la derecha y escriba "Wabash" .

    Búsqueda en la tabla.

  3. Todas las menciones de la expresión buscada se resaltan en la tabla. Para desplazarse entre ellas, puede presionar ENTRAR para avanzar o Mayús + ENTRAR para retroceder, o bien puede usar los botones arriba y abajo junto al cuadro de búsqueda.

    Exploración de los resultados de la búsqueda.

Compartir consultas

Muchas veces, desea consultar las consultas que crea.

  1. En la ventana de consulta, seleccione la primera consulta en la que copió.

  2. En la parte superior de la ventana de consulta, seleccione Compartir.

    Menú Compartir.

Las siguientes opciones están disponibles en el menú desplegable:

Puede proporcionar un vínculo profundo de modo que otros usuarios con acceso al clúster puedan ejecutar las consultas.

  1. En Share (Compartir), seleccione Link, query to clipboard (Vincular consulta al Portapapeles).

  2. Copie el vínculo y la consulta en un archivo de texto.

  3. Pegue el vínculo en una nueva ventana del explorador. El resultado debe tener un aspecto similar al siguiente.

    Vínculo profundo de consulta compartida.

Anclar al panel

Al completar la exploración de datos mediante consultas en la interfaz de usuario web y buscar los datos que necesita, puede anclarlos a un panel con fines de supervisión continua.

Para anclar una consulta:

  1. En Share (Compartir), seleccione Pin to dashboard (Anclar al panel).

  2. En Pin to dashboard (Anclar al panel):

    1. Escriba un valor en Query name (Nombre de consulta).
    2. Seleccione Use existing (Usar existente) o Create new (Crear nuevo).
    3. En Dashboard name (Nombre del panel), asigne un nombre al panel.
    4. Seleccione la casilla de verificación View dashboard after creation (Ver panel después de crear) si se trata de un panel nuevo.
    5. Seleccione Anclar.

    Panel Anclar al panel.

Nota

Pin to dashboard (Anclar al panel) únicamente ancla la consulta seleccionada. Para crear el origen de datos del panel y traducir los comandos de representación en un objeto visual del panel, se debe seleccionar la base de datos correspondiente en la lista de bases de datos.

Exportación de los resultados de la consulta

Para exportar los resultados de la consulta a un archivo CSV, seleccione File > Export to CSV (Archivo > Exportar a CSV).

Exportar los resultados a un archivo CSV.

Configuración

En la pestaña Configuración, puede:

Seleccione el icono de configuración en la parte superior derecha para abrir la ventana Configuración.

Ventana Configuración.

Exportación e importación de la configuración del entorno

Las acciones de exportación e importación le ayudan a proteger su entorno de trabajo y a reubicarlo en otros exploradores y dispositivos. La acción de exportación exportará toda la configuración, las conexiones del clúster y las pestañas de consulta a un archivo JSON que se pueda importar en otro explorador o dispositivo.

Exportación de la configuración del entorno

  1. En Configuración > General, seleccione Exportar.
  2. El archivo adx-export.json se descargará en el almacenamiento local.
  3. Seleccione Clear local state (Borrar estado local) para revertir el entorno a su estado original. Esta configuración elimina todas las conexiones del clúster y cierra las pestañas abiertas.

Nota

Exportar solo exporta los datos relacionados con la consulta. No se exportará ningún dato del panel dentro del archivo adx-export.json.

Importación de la configuración del entorno

  1. En Configuración > General, seleccione Importar. A continuación, en el elemento emergente Advertencia, seleccione Importar.

    Advertencia de importación.

  2. Busque el archivo adx-export.json en el almacenamiento local y ábralo.

  3. Ahora tiene a su disposición las conexiones del clúster y las pestañas abiertas anteriores.

Nota

Importar reemplaza los datos y la configuración del entorno existentes.

Resaltado de niveles de error

Kusto intenta interpretar la gravedad o el nivel de detalle de cada fila del panel de resultados y les asigna el color correspondiente. Para ello, hace coincidir los valores distintivos de cada columna con un conjunto de patrones conocidos ("Warning", "Error", etc.).

Habilitación del resaltado de niveles de error

Para habilitar el resaltado de niveles de error:

  1. Seleccione el icono Configuración junto a su nombre de usuario.

  2. Seleccione la pestaña Appearance (Apariencia) y active la opción Enable error level highlighting (Habilitar resaltado de niveles de error) a la derecha.

    GIF animado que muestra cómo habilitar el resaltado de niveles de error en la configuración.

Combinación de colores de niveles de error en el modo Claro Combinación de colores de niveles de error en el modo Oscuro
Captura de pantalla de la leyenda de colores del modo claro. Captura de pantalla de la leyenda de colores del modo oscuro.

Requisitos de columna para el resaltado

En el caso de los niveles de error resaltados, la columna debe ser del tipo int, long o string.

  • Si la columna es de tipo long o int:
    • El nombre de la columna debe ser Level.
    • Los valores solo pueden incluir números entre 1 y 5.
  • Si la columna es de tipo string:
    • Opcionalmente, el nombre de columna puede ser Level para mejorar el rendimiento.
    • La columna puede contener uno de los siguientes valores:
      • critical, crit, fatal, assert, high
      • error, e
      • warning, w, monitor
      • información
      • verbose, verb, d

Envío de comentarios

  1. En la parte superior derecha de la aplicación, seleccione el icono de comentarios .

  2. Escriba sus comentarios y, a continuación, seleccione Enviar.

Limpieza de recursos

No creó ningún recurso en esta guía de inicio rápido, pero si desea quitar uno o ambos clústeres de la aplicación, haga clic con el botón derecho en el clúster y seleccione Quitar conexión. Otra opción consiste en seleccionar Clear local state (Borrar estado local) en Configuración > General. Esta acción quitará todas las conexiones del clúster y cerrará todas las pestañas de consulta abiertas.

Pasos siguientes

Write queries for Azure Data Explorer (Escritura de consultas del Explorador de datos de Azure)