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.

Requisitos previos

• Suscripción a Azure. Cree una cuenta de Azure gratuita.
• Cree un clúster y una base de datos, o use el clúster de ayuda de Azure Data Explorer.

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.

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 el menú de la izquierda, seleccione Query (Consulta).

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

3. En el cuadro de diálogo Agregar clúster, escriba el URI y, a continuación, seleccione Agregar.

4. 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.

   

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 la dirección URL del clúster de prueba con el formato y, a continuación, seleccione Agregar. Por ejemplo, https://mydataexplorercluster.westus.kusto.windows.net tal como se muestra en la siguiente imagen:

   

3. En el ejemplo siguiente, verá el clúster de ayuda y un nuevo clúster, docscluster.westus (la dirección URL completa es ).

   

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.

   

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

   

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.

   

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.

   

   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.

   

   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.

Trabajo con la cuadrícula de resultados

Ahora que ha visto cómo funcionan las consultas básicas, puede usar la cuadrícula de resultados 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.

   

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.

   

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.

   

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.

   

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.

   

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.

   

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 valory, después, seleccione el tipo de función que desea hacer en esta columna.

   

Ocultar columnas vacías

Para ocultar o mostrar columnas vacías, puede alternar el icono de ojo en el menú de cuadrícula de 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.

   

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.

   

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).

   

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

   

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.

   

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).

   

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

   

Búsqueda en la cuadrícula 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" .

   

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.

   

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.

   

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

• Link to clipboard (Vincular al Portapapeles)
• Link query to clipboard (Vincular consulta al Portapapeles)
• Link, query, results to clipboard (Vincular consulta y resultados al Portapapeles)
• Anclar al panel
• Consulta en Power BI

Proporcionar un vínculo profundo

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.

   

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.

   

Exportación de los resultados de la consulta

Para exportar los resultados de la consulta a un archivo CSV, seleccione Exportación dearchivos a CSV.

Configuración

En la pestaña Configuración, puede:

• Exportar la configuración del entorno
• Importar la configuración del entorno
• Resaltado de niveles de error
• Borrar el estado local
• Cambio de datetime a una zona horaria específica

Seleccione el icono de configuración en la parte superior derecha para abrir la 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 la ConfiguraciónGeneral, 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.

Importación de la configuración del entorno

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

   

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.

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.

   

Combinación de colores de niveles de error en el modo Claro	Combinación de colores de niveles de error en el 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

Cambio de datetime a una zona horaria específica

Puede cambiar los valores datetime mostrados para reflejar una zona horaria específica. Este cambio solo afecta a la presentación y no cambia los datos subyacentes en Azure Data Explorer.

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

2. Seleccione la pestaña General y seleccione una zona horaria en el menú desplegable.

   

La zona horaria seleccionada estará visible en la barra de menús de la cuadrícula de resultados.

Envío de comentarios

1. En la esquina 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 es seleccionar Borrar estado local en la ConfiguraciónGeneral. Esta acción quitará todas las conexiones de 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)