Compartir a través de


Instalación e interfaz de usuario de Kusto.Explorer

Se aplica a: ✅Microsoft FabricAzure Data Explorer

Kusto.Explorer es una herramienta gratuita de escritorio de Windows. Úselo para consultar y analizar datos con el lenguaje de consulta kusto (KQL) en una interfaz fácil. En este artículo se describe cómo configurar Kusto.Explorer y su interfaz de usuario.

Usa Kusto.Explorer para:

Instalación de Kusto.Explorer

  • Descargue e instale Kusto.Explorer desde:

  • O bien, use un explorador habilitado para ClickOnce para acceder al clúster de Kusto en: https://<your_cluster>/?web=0 Reemplace el marcador de posición por el <your_cluster> URI del clúster (por ejemplo, help.kusto.windows.net).

Uso de Google Chrome con Kusto.Explorer

Si Google Chrome es su explorador predeterminado, instale la extensión ClickOnce. Extensión ClickOnce para Chrome

Si Microsoft Edge es el explorador predeterminado, no necesita esta extensión. Compruebe la configuración de ClickOnce en las marcas de Microsoft Edge.

Información general de la interfaz de usuario

Kusto.Explorer usa pestañas y paneles:

  • Use el panel de menús para realizar tareas.
  • Administrar conexiones en el panel de conexiones.
  • Cree y ejecute scripts en el panel de scripts.
  • Ver los resultados del script en el panel de resultados.

Captura de pantalla de Kusto.Explorer que muestra cuatro paneles principales: menú, conexiones, script y resultados.

Panel Connections (Conexiones)

Captura de pantalla del panel Conexiones que muestra las bases de datos del clúster de Ayuda.

En el panel Conexiones se enumeran todas las conexiones de clúster configuradas. Para cada clúster, enumera las bases de datos, las tablas y las columnas. Seleccione un elemento para establecer el contexto de la búsqueda o consulta en el panel principal. Para copiar un nombre en el panel de búsqueda o consulta, haga doble clic en el elemento.

Si el esquema es grande (por ejemplo, una base de datos con cientos de tablas), seleccione Ctrl+F y escriba una parte que no distingue mayúsculas de minúsculas del nombre de entidad que se va a buscar.

Controle el panel Conexiones desde la ventana de consulta para admitir flujos de trabajo con scripts. Inicie el script con un comando que indique a Kusto.Explorer que se conecte al clúster y a la base de datos que consulta el script:

#connect cluster('help').database('Samples')

StormEvents | count

Ejecute cada línea con F5.

Panel Documentos de trabajo

Captura de pantalla del panel Documentos de trabajo en el que se muestran las carpetas Trabajo no guardado y Seguimiento.

El panel Carpetas de trabajo organiza las carpetas de trabajo para la navegación rápida. Incluye dos tipos:

  • Trabajo no guardado: carpetas de pestañas de consulta abiertas que todavía está editando
  • Carpetas con seguimiento: carpetas de dispositivo que agrega como bibliotecas de KQL para facilitar el acceso y la administración

Pestaña Inicio

Captura de pantalla de la pestaña Inicio que muestra las cinco secciones de la pestaña Inicio.

En la pestaña Inicio se muestran las operaciones usadas con más frecuencia. Incluye:

Sección Query (Consultar)

Captura de pantalla de la sección pestaña Inicio titulada Pestañas que muestra una opción para crear una nueva pestaña para las consultas.

Menu Comportamiento
Menú desplegable de modos
  • Modo de consulta: cambia el editor de consultas al modo de consulta. Escribe y guarda comandos como consultas (valor predeterminado).
  • Modo de búsqueda: procesa cada comando inmediatamente y muestra un resultado en el panel de resultados.
  • Modo search++: permite buscar un término en una o varias tablas mediante la sintaxis de búsqueda. Obtenga más información sobre el uso del modo Search++.
New Tab (Nueva pestaña) Abre una nueva pestaña de consulta para el lenguaje de consulta kusto (KQL).

Sección Share (Compartir)

Captura de pantalla de la sección Inicio pestaña titulada Compartir que muestra tres opciones.

Menu Comportamiento
Data To Clipboard (Datos en el Portapapeles) Copia la consulta y el conjunto de datos en el Portapapeles. Si se muestra un gráfico, también copia el gráfico como un mapa de bits.
Result To Clipboard (Resultado en el Portapapeles) Copia el conjunto de datos en el Portapapeles. Si se muestra un gráfico, también copia el gráfico como un mapa de bits.
Query to Clipboard (Consulta en el Portapapeles) Copia la consulta en el Portapapeles.

Sección Visualizations (Visualizaciones)

Captura de pantalla de la sección Inicio pestaña titulada Visualizaciones que muestra las distintas opciones para visualizar los datos.

Para obtener más opciones de visualización, consulte el operador render.

Menu Comportamiento
Gráfico de áreas Muestra un gráfico de áreas donde la primera columna (numérica) es el eje X. Asigna cada columna numérica a una serie independiente del eje Y.
Gráfico de columnas Muestra un gráfico de columnas donde todas las columnas numéricas se asignan a diferentes series (eje Y). La columna de texto anterior a numeric es el eje X (se puede controlar en la interfaz de usuario).
Gráfico de barras Muestra un gráfico de barras donde todas las columnas numéricas se asignan a diferentes series (eje X). La columna de texto anterior a numeric es el eje Y (se puede controlar en la interfaz de usuario).
Gráfico de áreas apiladas Muestra un gráfico de áreas apiladas en el que el eje X es la primera columna (debe ser numérica). Todas las columnas numéricas están asignadas a diferentes series (eje Y).
Gráfico de hora Muestra un gráfico de tiempo en el que el eje X es la primera columna (debe ser datetime). Todas las columnas numéricas están asignadas a diferentes series (eje Y).
Gráfico de líneas Muestra un gráfico de líneas en el que el eje X es la primera columna (debe ser numérica). Todas las columnas numéricas están asignadas a diferentes series (eje Y).
Anomaly Chart (Gráfico de anomalías) Similar al gráfico de tiempo, pero detecta anomalías en los datos de serie temporal mediante un algoritmo de aprendizaje automático. Los datos deben utilizar segmentos de intervalo fijo. Para la detección de anomalías, Kusto.Explorer usa la función series_decompose_anomalies.
Gráfico circular Muestra un gráfico circular en el que el eje de colores es la primera columna. El eje theta (debe ser una medida, convertida en porcentaje) es la segunda columna.
Time Ladder (Escalera de tiempo) Muestra un gráfico escalonado en el que el eje X son las dos últimas columnas (que deben ser datetime). El eje Y es una combinación de las demás columnas.
Gráfico de dispersión Muestra un gráfico de puntos en el que el eje X es la primera columna (debe ser numérica). Todas las columnas numéricas están asignadas a diferentes series (eje Y).
Gráfico dinámico Muestra una tabla dinámica y un gráfico que le permite seleccionar datos, columnas, filas y tipos de gráfico.
Time Pivot (Gráfico dinámico de tiempo) Le permite navegar por la línea de tiempo de eventos de forma interactiva (centrándose en el eje de tiempo).

Sección View (Vista)

Captura de pantalla de la sección Inicio pestaña titulada Vista que muestra las opciones para modificar la vista de datos.

Menu Comportamiento
Full View Mode (Modo de vista completa) Maximiza el área de trabajo ocultando el menú de la cinta de opciones y el Panel de conexión. Para salir de este modo, seleccione Home>Full View Mode o presione F11.
Hide Empty Columns (Ocultar columnas vacías) Quita las columnas vacías de la cuadrícula de datos.
Collapse Singular Columns (Contraer columnas singulares) Contrae columnas con valores singulares.
Explore Column Values (Explorar valores de columna) Muestra la distribución de valores de columna.
Aumentar fuente Aumenta el tamaño de fuente en la pestaña de consulta y la cuadrícula de resultados.
Reducir fuente Disminuye el tamaño de fuente en la pestaña de consulta y la cuadrícula de resultados.

Nota:

Configuración de la vista de datos:

Kusto.Explorer realiza un seguimiento de la configuración de cada conjunto único de columnas. Al reordenar o quitar columnas, guarda la vista de datos y la reutiliza al recuperar datos con las mismas columnas. Para restablecer la vista a sus valores predeterminados, en la pestaña Ver , seleccione Restablecer vista.

Pestaña Archivo

Captura de pantalla de la pestaña Archivo que muestra las cinco secciones de la pestaña Archivo.

Menu Comportamiento
Script de consulta
New Tab (Nueva pestaña) Abre una nueva ventana de pestaña para consultar Kusto.
Abrir archivo Carga un script .kql en el panel de consulta activo.
Save To File (Guardar en el archivo) Guarda el script activo en un archivo .kql.
Close Tab (Cerrar pestaña) Cierra la pestaña actual.
Perfiles
Perfil de importación Importa un perfil de Kusto.Explorer.
Perfil de exportación Exporta un perfil de Kusto.Explorer.
Guardar datos
Data To CSV (Datos en CSV) Exporta datos a un archivo CSV (valores separados por comas).
Data To JSON (Datos en JSON) Exporta datos a un archivo con formato JSON.
Data To Excel (Datos en Excel) Exporta datos a un archivo XLSX (Excel).
Data To Text (Datos en texto) Exporta datos a un archivo TXT (texto).
Data To KQL Script (Datos en script en KQL) Exporta la consulta a un archivo de script.
Data To Results (Datos en resultados) Exporta la consulta y los datos a un archivo de resultados (QRES).
Run Query Into CSV (Ejecutar consulta en CSV) Ejecuta la consulta y guarda los resultados en un archivo CSV local.
Carga de datos
From Results (Desde resultados) Carga la consulta y los datos de un archivo de resultados (QRES).
Portapapeles
Query and Results To Clipboard (Consulta y resultados en el Portapapeles) Copia la consulta y el conjunto de datos en el Portapapeles. Si se muestra un gráfico, copia el gráfico como un mapa de bits.
Result To Clipboard (Resultado en el Portapapeles) Copia el conjunto de datos en el Portapapeles. Si se muestra un gráfico, copia el gráfico como un mapa de bits.
Consulta al Portapapeles Copia la consulta en el Portapapeles.
Resultados al Portapapeles (datatable()) Copia los resultados de la consulta en el Portapapeles. El valor máximo permitido de celda es 30 000.
Results
Clear results cache (Borrar caché de resultados) Borra los resultados almacenados en caché de las consultas ejecutadas anteriormente.

Pestaña Connections (Conexiones)

Captura de pantalla de la pestaña Conexiones que muestra las cinco secciones de la pestaña Conexión.

Menu Comportamiento
Grupos
Agregar grupo Agregue un grupo de servidores Kusto.
Clústeres
Import Connections (Importar conexiones) Importar conexiones desde un archivo.
Export Connections (Exportar conexiones) Exportar conexiones a un archivo.
Agregar conexión Agregue una conexión de servidor Kusto.
Edit Connection (Editar conexión) Abra el cuadro de diálogo propiedades de conexión.
Remove Connection (Quitar conexión) Quite la conexión del servidor Kusto.
Actualizar Actualice las propiedades de conexión.
Perfiles
Perfil de importación Importe un perfil de Kusto.Explorer.
Perfil de exportación Exporte un perfil de Kusto.Explorer.
Security
Inspect Your ADD Principal (Inspeccionar entidad de seguridad de ADD) Muestra los detalles actuales del usuario que ha iniciado sesión.
Cierre de sesión Cierre la sesión del usuario actual de Microsoft Entra ID.
Ámbito de datos
Caching scope (Ámbito del almacenamiento en caché)
  • Datos activos: ejecute consultas solo en la caché de datos activa.
  • Todos los datos: ejecute consultas en todos los datos disponibles (valor predeterminado).
Columna DateTime Nombre de una columna que puede usar para un prefiltro de tiempo.
Time Filter (Filtro de tiempo) Valor del prefiltro de tiempo.

Pestaña Vista

Captura de pantalla de la pestaña Ver que muestra cuatro secciones: Apariencia, Vista de datos, Filtrado de datos y Visualizaciones.

Menu Comportamiento
Apariencia
Full View Mode (Modo de vista completa) Maximiza el espacio de trabajo ocultando el menú de la cinta de opciones y el panel de conexiones. Salga del modo de vista completa seleccionando Modo>de vista completa principal o presionando **F11 .
Increase Font (Agrandar fuente) Aumenta el tamaño de fuente de la pestaña de consulta y de la cuadrícula de datos de resultados.
Decrease Font (Reducir fuente) Disminuye el tamaño de fuente de la pestaña de consulta y de la cuadrícula de datos de resultados.
Reset Layout (Restablecer diseño) Restablece el diseño de acoplamiento y las ventanas.
Rename Document Tab (Cambiar nombre de la pestaña del documento) Cambia el nombre de la pestaña seleccionada.
Vista de datos
Restablecer vista Restablece la configuración de la vista de datos a sus valores predeterminados.
Explore Column Values (Explorar valores de columna) Muestra la distribución de valores de columna.
Focus on Query Statistics (Establecer foco sobre las estadísticas de la consulta) Muestra las estadísticas de consulta en lugar de los resultados cuando finaliza la consulta.
Hide Duplicates (Ocultar duplicados) Alterna la opción de eliminación de filas duplicadas de los resultados.
Hide Empty Columns (Ocultar columnas vacías) Quita las columnas vacías de los resultados.
Collapse Singular Columns (Contraer columnas singulares) Contrae las columnas que contienen un único valor.
Selección de fila Habilita la selección de filas específicas en el panel Resultados.
Color por columna Resalta valores idénticos en la primera columna.
Ajustar texto Envuelve el contenido de la celda para que se ajuste al ancho de la columna.
Filtrado de datos
Filter Rows In Search (Filtrar filas en la búsqueda) Alternancias que muestran solo filas coincidentes al buscar ( Ctrl+F ).
Visualizaciones
Visualizaciones Consulte Visualizaciones.

Nota:

Configuración de la vista de datos:

Kusto.Explorer realiza un seguimiento de la configuración por conjunto único de columnas. Al reordenar o quitar columnas, guarda la vista de datos y la reutiliza cuando recupera datos con las mismas columnas. Para restablecer los valores predeterminados, en la pestaña Ver , seleccione Restablecer vista.

Pestaña Herramientas

Captura de pantalla de la pestaña Herramientas que muestra sus seis secciones.

Menu Comportamiento
IntelliSense
Habilitar IntelliSense Habilita o deshabilita IntelliSense en el panel Script.
Lista de problemas Muestra los problemas en el panel Script.
Automatización
Agregar nueva automatización Genera un informe con información de consulta.
Utilidades
Herramientas de línea de comandos Abre un símbolo del sistema.
Comprimir archivo LZ4 Comprime los archivos con el algoritmo LZ4.
Archivo LZ4 de descompress Descomprime los archivos con el algoritmo LZ4.
Análisis de datos
Analytical Reports (Informes analíticos) Abre un panel con informes de análisis de datos creados previamente.
Translate
Consulta en Power BI Convierte una consulta en un formato de Power BI.
Consulta a WPA Convierte una consulta en un formato WPA.
Consulta a WPA (Portapapeles) Convierte una consulta en un formato WPA y la copia en el Portapapeles.
Opciones
Reset Options (Restablecer opciones) Restablece la configuración de la aplicación a los valores predeterminados.
Opciones Abre la herramienta de opciones para configurar las opciones de la aplicación. Para obtener más información, consulte Opciones de Kusto.Explorer.

Colores de las filas de tabla

Kusto.Explorer evalúa el nivel de gravedad o verbosidad de cada fila en el panel de resultados y colorea las filas en consecuencia. Hace coincidir distintos valores de columna con patrones conocidos (por ejemplo, "Advertencia", "Error").

Para cambiar la combinación de colores de salida o desactivar este comportamiento, seleccione Herramientas>Opciones>Visor de Resultados>Esquema de colores de verbosidad.

Captura de pantalla de la modificación de la combinación de colores del Explorador de Kusto.

Leyenda de la combinación de colores Excel Leyenda de la combinación de colores Vivid
Captura de pantalla de la leyenda de combinación de colores de Excel en el Explorador de Kusto. Captura de pantalla de la leyenda de combinación de colores vívida en el Explorador de Kusto.

Pestaña Monitoring (Supervisión)

Captura de pantalla de la pestaña Supervisión con dos opciones para la supervisión de datos.

Menu Comportamiento
Monitor
Cluster Diagnostics (Diagnósticos del clúster) Muestra un resumen de estado del grupo de servidores seleccionado actualmente en el Panel de conexiones.
Datos más recientes: Todas las tablas Muestra un resumen de los datos más recientes de todas las tablas de la base de datos seleccionada actualmente.
Datos más recientes: tabla seleccionada Muestra los datos más recientes de la tabla seleccionada en la barra de estado.

Pestaña Management (Administración)

Captura de pantalla de la pestaña Administración que muestra las opciones para administrar principales autorizados.

Menu Comportamiento
Principales autorizados
Manage Database Authorized Principals (Administrar las entidades de seguridad autorizadas de la base de datos) Permite a los usuarios autorizados administrar principales de base de datos.
Manage Table Authorized Principals (Administrar las entidades de seguridad autorizadas de la tabla) Permite a los usuarios autorizados gestionar los principales de tabla.
Manage Function Authorized Principals (Administrar las entidades de seguridad autorizadas de la función) Permite a los usuarios autorizados administrar los principales de función.

Pestaña Ayuda

Captura de pantalla de la pestaña Ayuda que muestra las opciones de Documentación.

Menu Comportamiento
Documentación
Ayuda Abre la documentación en línea de Kusto.
Novedades Abre las notas de lanzamiento de Kusto.Explorer.
Métodos abreviados de teclado Abre los atajos de teclado de Kusto.Explorer.
Mostrar CLUF Abre el artículo Información legal de Microsoft Azure.
Soporte técnico y comentarios
Informe de problemas Abre un cuadro de diálogo con dos opciones: .
Sugerir función Abre una página para compartir tus ideas.
Soporte técnico de Kusto (bot KAI) Abre KAI para autoservicio, instrucciones proactivas y solución de problemas autónomos.

Control de la identidad del usuario que se conecta a Kusto.Explorer

El modelo de seguridad predeterminado para las nuevas conexiones es la seguridad federada de Id. de Microsoft Entra. La autenticación usa Microsoft Entra ID con la experiencia de inicio de sesión predeterminada de Microsoft Entra.

Para un control más preciso sobre los parámetros de autenticación, expanda el cuadro Opciones avanzadas: Cadenas de conexión y escriba una cadena de conexión kusto válida.

Por ejemplo, los usuarios de varios clientes de Microsoft Entra a veces necesitan seleccionar una identidad específica en un cliente de destino. Use la cadena de conexión para especificarla. Reemplace los valores de marcador de posición entre corchetes angulares por sus propios valores:

Data Source=https://<ClusterName>.kusto.windows.net;Initial Catalog=<DatabaseName>;AAD Federated Security=True;Authority Id=<TenantId>;User=<UserIdentity>
  • <TenantId> es el nombre de dominio o el identificador de inquilino de Microsoft Entra (un GUID) del inquilino que hospeda el clúster (por ejemplo, contoso.com).
  • <UserIdentity> es la identidad de usuario invitada a esa entidad (por ejemplo, user@example.com).

Nota:

El nombre de dominio del usuario puede diferir del inquilino que hospeda el clúster.

Captura de pantalla del panel Agregar conexión que muestra la opción denominada Cadena de conexión avanzada.