Uso de Kusto.Explorer

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Kusto.Explorer es una aplicación de escritorio que permite explorar los datos mediante el Lenguaje de consulta Kusto en una interfaz de usuario fácil de usar. En este artículo se muestra cómo usar los modos de búsqueda y consulta, compartir las consultas y administrar clústeres, bases de datos y tablas.

Modo De búsqueda++

El modo Search++ permite buscar un término mediante la sintaxis de búsqueda en una o varias tablas.

1. En la lista desplegable Consulta de la pestaña Inicio , seleccione Buscar++.

2. Seleccione Varias tablas.

3. En Elegir tablas, defina qué tablas buscar y, a continuación, seleccione Aceptar.

4. En el cuadro de edición, escriba la frase de búsqueda y seleccione Ir.

   Un mapa térmico de la cuadrícula de tabla/espacio de tiempo muestra qué términos aparecen y dónde aparecen.

   

5. Seleccione una celda en la cuadrícula y seleccione Ver detalles para mostrar las entradas pertinentes en el panel de resultados.

   

modo de consulta

Kusto.Explorer incluye un modo de consulta eficaz que permite escribir, editar y ejecutar consultas insertadas. El modo de consulta incluye el resaltado de sintaxis e IntelliSense, por lo que puede aumentar rápidamente el conocimiento del Lenguaje de consulta Kusto.

En esta sección se describe cómo ejecutar consultas básicas en Kusto.Explorer y cómo agregar parámetros a las consultas.

Consultas básicas

Si tiene registros de tabla, puede empezar a explorarlos:

StormEvents | count 

Cuando el cursor está en esta línea, es gris coloreado. Presione F5 para ejecutar la consulta.

Estas son algunas consultas de ejemplo más:

// Take 10 lines from the table. Useful to get familiar with the data
StormEvents | take 10 

// Filter by EventType == 'Flood' and State == 'California' (=~ means case insensitive) 
// and take sample of 10 lines
StormEvents 
| where EventType == 'Flood' and State =~ 'California'
| take 10

Para obtener más información sobre el Lenguaje de consulta Kusto, consulte Lenguaje de consulta Kusto.

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.

Parametrización de consultas del lado cliente

Nota:

Hay dos tipos de técnicas de parametrización de consulta en Kusto:

• La parametrización de consultas integrada en lenguaje se implementa en el lado servidor y está diseñada para usarse en aplicaciones que consultan el servicio mediante programación. Este método no se describe en este documento.

• La parametrización de consultas del lado cliente es una característica de la aplicación Kusto.Explorer solo. Es equivalente a usar operaciones de reemplazo de cadenas en las consultas antes de enviarlos para que el servicio los ejecute. La sintaxis no forma parte del propio lenguaje de consulta y no se puede usar al enviar consultas al servicio por medios distintos de Kusto.Explorer.

Si usa el mismo valor en varias consultas o en varias pestañas, es muy inconveniente cambiar ese valor en cada lugar que se usa. Para mayor comodidad, Kusto.Explorer admite parámetros de consulta. Los parámetros de consulta se comparten entre pestañas para que se puedan reutilizar fácilmente. Los parámetros se indican entre {} corchetes. Por ejemplo, {parameter1}.

Puede definir y editar fácilmente los parámetros de consulta existentes:

Puede tener varios conjuntos de parámetros (enumerados en el cuadro combinado Conjunto de parámetros). Seleccione Agregar nuevo o Eliminar actual para manipular la lista de conjuntos de parámetros.

Uso compartido de consultas y resultados

En Kusto.Explorer, puede compartir consultas y resultados por correo electrónico. También puede crear vínculos profundos que abran y ejecuten una consulta en el explorador.

Uso compartido de consultas y resultados por correo electrónico

Kusto.Explorer proporciona una manera cómoda de compartir consultas y resultados de consulta por correo electrónico.

1. Ejecute la consulta en Kusto.Explorer.

2. En la pestaña Inicio , en la sección Compartir , seleccione Consulta y resultados en portapapeles (o presione Ctrl+Mayús+C).

   

   Kusto.Explorer copia lo siguiente en el Portapapeles:

   • La consulta
   • Resultados de la consulta (tabla o gráfico)
   • Los detalles de conexión del centro de eventos y la base de datos
   • Vínculo que vuelve a ejecutar la consulta automáticamente

3. Pegue el contenido del Portapapeles en un nuevo mensaje de correo electrónico.

Consultas de vinculación profunda

Puede crear un URI que, cuando se abre en un explorador, abre Kusto.Explorer localmente y ejecuta una consulta específica en una base de datos kusto especificada.

Nota:

Por motivos de seguridad, la vinculación profunda está deshabilitada para los comandos de administración.

Creación de un vínculo profundo

La manera más fácil de crear un vínculo profundo es crear la consulta en Kusto.Explorer y, a continuación, usar Query and results to Clipboard para copiar la consulta (incluido el vínculo profundo y los resultados) en el Portapapeles. Después, puede compartirlo por correo electrónico.

Cuando se copia en un correo electrónico, se muestran varios vínculos que se van a ejecutar en una fuente pequeña. Por ejemplo:

Execute: [Web] [Desktop] [Web (Lens)] [Desktop (SAW)] https://trd-1234.kusto.fabric.microsoft.com

El vínculo Web abre la consulta en Azure Data Explorer. El vínculo De escritorio es el vínculo profundo. Abre la consulta en Kusto.Explorer y establece el contexto correctamente.

Si mueve el vínculo a un mensaje de correo electrónico y presiona CTRL+K, puede ver la dirección URL real.

Vínculos profundos y consultas parametrizadas

Puede usar consultas parametrizadas con vinculación profunda.

1. Cree una consulta que se formará como una consulta parametrizada (por ejemplo, KustoLogs | where Timestamp > ago({Period}) | count)

1. Proporcione un parámetro para cada parámetro de consulta en el URI. Para copiar el URI, en el panel de consulta de KQL de Fabric, seleccione Copiar vínculo de consulta>al Portapapeles.

2. Después del vínculo en el panel de consulta kusto.Explorer.

Nota:

Para asegurarse de que puede ejecutar la consulta en Kusto.Explorer, asegúrese de que puede conectarse a la base de datos a la que se hace referencia en la consulta.

Limitaciones

Las consultas se limitan a aproximadamente 2000 caracteres debido a limitaciones del explorador, servidores proxy HTTP y herramientas que validan vínculos, como Microsoft Outlook. La limitación es aproximada porque depende del clúster y la longitud del nombre de la base de datos. Para obtener más información, vea https://support.microsoft.com/kb/208427.

Para reducir las posibilidades de alcanzar el límite de caracteres, vea Obtener vínculos más cortos.

El URI abre Kusto.Explorer y ejecuta la consulta especificada. Se abre una nueva pestaña si ya hay una instancia en ejecución.

Obtención de vínculos más cortos

Las consultas pueden ser largas. Para reducir la posibilidad de que la consulta supere la longitud máxima, use el String Kusto.Data.Common.CslCommandGenerator.EncodeQueryAsBase64Url(string query) método disponible en la biblioteca cliente de Kusto. Este método genera una versión más compacta de la consulta. Kusto.Explorer también reconoce el formato más corto.

<https://\BaseAddress>/groups/1234ab-cd55-6789-0123-e4567fg890hi/databases/01234abc-defg-6789-4567fg890hi?experience=power-bi&extensionScenario=openArtifact&query=1234AAAAAAAAAAAAAAAAAAAAA567890BBBBBBBBBB01234567890CCCCCCCCC1234AAAAAAAAAAAAAAAAAAAAA567890BBBBBBBBBBBBBB01234567890CCCCCCCCC1234AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA567890BBBBBBBBBBBB01234567890CCCCCCC%AB%AB%AB

La consulta se hace más compacta aplicando la siguiente transformación:

 UrlEncode(Base64Encode(gzip(original query)))

Argumentos de la línea de comandos de Kusto.Explorer

Los argumentos de la línea de comandos se usan para configurar la herramienta para realizar más funciones en el inicio. Por ejemplo, cargue un script y conéctese a un clúster. Por lo tanto, los argumentos de la línea de comandos no son un reemplazo de ninguna funcionalidad de Kusto.Explorer.

Los argumentos de la línea de comandos se pasan como parte de la dirección URL que se usa para abrir la aplicación, de forma similar a la consulta de vinculación profunda.

Sintaxis de argumentos de línea de comandos

Kusto.Explorer admite varios argumentos de línea de comandos en la sintaxis siguiente (el orden es importante):

[LocalScriptFile] [QueryString]

Argumentos de la línea de comandos

Argumento de línea de comandos	Descripción
LocalScriptFile	Nombre de un archivo de script en el equipo local, que debe tener la extensión .kql. Si el archivo existe, Kusto.Explorer carga automáticamente el archivo cuando se inicia.
QueryString	Cadena que usa formato de cadena de consulta HTTP. Este método proporciona más propiedades, como se describe en la tabla siguiente.

Argumentos de cadena de consulta

Argumento	Descripción
Consulta que se va a ejecutar
query	La consulta que se va a ejecutar (gzipped y, a continuación, codificada en base64; consulte Obtención de vínculos más cortos). Si no se especifica, usa querysrc.
querysrc	Dirección URL de un archivo o blob que contiene la consulta que se va a ejecutar.
Conexión al clúster de Kusto
uri	El cadena de conexión del clúster de Kusto al que conectarse.
name	Nombre para mostrar de la conexión al clúster de Kusto.
Grupo de conexiones
path	Dirección URL de un archivo de grupo de conexiones que se va a descargar (con codificación URL).
group	Nombre del grupo de conexiones.
filename	Archivo local que contiene el grupo de conexiones.

Ejemplo

Para iniciar Kusto.Explorer con un archivo de script denominado c:\temp\script.kql y configurado para comunicarse con un grupo y una base de datos específicos, use el siguiente comando:

Kusto.Explorer.exe c:\temp\script.kql "uri=https://<baseaddress>/groups/<GroupID>/databases/<DatabaseID>"

Administrar bases de datos, tablas o entidades de seguridad autorizadas para funciones

Importante

Solo los administradores pueden agregar o quitar entidades de seguridad autorizadas en su propio ámbito.

1. Para ver la lista de entidades de seguridad autorizadas, haga clic con el botón derecho en la entidad de destino en el panel Conexiones y seleccione Administrar entidades de seguridad autorizadas de base de datos. (También puede seleccionar esta opción en el menú Administración).

   

2. Seleccione Agregar entidad de seguridad para agregar una entidad de seguridad autorizada.

3. Proporcione los detalles de la entidad de seguridad y seleccione Agregar entidad de seguridad.

   

4. Confirme que desea agregar la entidad de seguridad autorizada.

   

Para quitar una entidad de seguridad autorizada existente, seleccione Quitar entidad de seguridad y confirme la acción.

Contenido relacionado

• Métodos abreviados de teclado de Kusto.Explorer
• Opciones de Kusto.Explorer
• Solución de problemas de Kusto.Explorer
• Características de código de Kusto.Explorer
• Lenguaje de consulta de Kusto (KQL)