Consulta de datos en un conjunto de consultas KQL

En este artículo, aprenderás a usar un nuevo conjunto de consultas KQL. El conjunto de consultas KQL es el elemento utilizado para ejecutar consultas, ver y personalizar los resultados de las consultas sobre los datos de diferentes orígenes de datos, como una instancia de Eventhouse, una base de datos KQL y mucho más.

El conjunto de consultas KQL usa el lenguaje de consultas de Kusto para crear consultas y también admite muchas funciones de SQL. Para más información sobre el lenguaje de consulta, consulte Introducción al Lenguaje de consulta Kusto.

Requisitos previos

• Un área de trabajo con una capacidad habilitada para Microsoft Fabric
• Una base de datos KQL con permisos de edición y datos, o un clúster y una base de datos de Azure Data Explorer con permisos AllDatabaseAdmin.

Selección de una base de datos

Las consultas se ejecutan en el contexto de una base de datos. Puede cambiar la base de datos asociada en cualquier momento y conservar las consultas guardadas en el editor de consultas. Puede asociar el conjunto de consultas KQL a varios orígenes de datos de distintos tipos, incluida una base de datos KQL o una base de datos de un clúster de Azure Data Explorer.

Selecciona la pestaña correspondiente con el tipo de base de datos deseado.

Base de datos KQL

1. Abre el conjunto de consultas KQL.

2. En el panel de conexión del lado izquierdo de la página de consulta, en Explorador, seleccione V para expandir el menú de conexiones de base de datos.

   

3. En Conector de origen, selecciona Centro de datos OneLake.

4. En la ventana Centro de datos de OneLake que aparece, seleccione una base de datos KQL para conectarla al conjunto de consultas KQL y, a continuación, seleccione Conectar. Como alternativa, cierre la ventana del centro de datos de OneLake y use el menú +Agregar origen de datos para conectarse a otro origen de datos.

Clúster de Azure Data Explorer

1. Abre el conjunto de consultas KQL.

2. En el panel de conexión del lado izquierdo de la página de consulta, en Explorador, seleccione V para expandir el menú de conexiones de base de datos.

   

3. En Conector de origen, selecciona Azure Data Explorer.

4. En URI de conexión, escribe el URI del clúster.

   Para buscar el URI de conexión, ve al recurso de clúster en Azure Portal. El URI de conexión es el URI que se encuentra en Información general. Para añadir un clúster de ejemplo gratuito, especifica «help» como el URI de conexión.

   

5. En Base de datos, selecciona el menú desplegable para expandir la lista de bases de datos del clúster y, a continuación, selecciona una base de datos.

6. Seleccione Conectar.

Aparece una lista de tablas asociadas a esta base de datos debajo del nombre de la base de datos en el panel de conexión.

Interacción con bases de datos mediante el panel de conexión

El panel de conexión permite examinar y cambiar entre las bases de datos conectadas al conjunto de consultas. En el panel de conexión, en Base de datos, seleccione V para expandir el menú de conexiones de base de datos. Seleccione la base de datos que quiere explorar. El panel de conexión muestra un desglose de los siguientes elementos que se incluyen en la base de datos seleccionada:

• Tablas
• Materialized View
• Accesos directos
• Funciones

En el panel de conexión, puede explorar qué elementos se incluyen en cada sección. Para abrir el menú de acciones, mantenga el puntero sobre el elemento y seleccione el menú Más [...]. El menú ofrece opciones para:

• Actualización de datos
• Ver perfil de datos
• Insertar para crear un script y pegarlo en el editor de consultas
• Eliminar

Hay diferentes acciones disponibles para diferentes tipos de elementos.

Escriba una consulta.

Ahora que está conectado al origen de datos, puede ejecutar consultas sobre estos datos. El conjunto de consultas KQL usa el Lenguaje de consulta Kusto (KQL) para consultar datos de cualquiera de las bases de datos a las que tiene acceso. Para obtener más información sobre KQL, consulte Información general sobre el Lenguaje de consulta Kusto (KQL).

En los ejemplos siguientes se usan datos que están disponibles públicamente en https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Escriba o copie una consulta en el panel superior del conjunto de consultas KQL.

2. Seleccione el botón Ejecutar o presione Mayús+Entrar para ejecutar la consulta.

   La salida de la consulta resultante se muestra en la cuadrícula de resultados, que aparece debajo del panel de consulta. Observe la marca verde que indica que la consulta se ha completado correctamente, y el tiempo utilizado para calcular los resultados de la consulta.

   

Administrar pestañas del conjunto de consultas

Dentro de un conjunto de consultas KQL, podrás crear varias pestañas. Cada pestaña se puede asociar a una base de datos KQL diferente y permite que las consultas guardadas se usen o compartan con otros usuarios para colaborar en la exploración de datos. También puede cambiar la base de datos KQL asociada a cualquier pestaña, lo que le permite ejecutar la misma consulta sobre datos en distintos estados.

• Agregar una nueva pestaña: seleccione el signo más + a la derecha de las pestañas existentes. Las distintas pestañas se pueden conectar a bases de datos diferentes.
• Cambiar el nombre de una pestaña: seleccione el icono de lápiz situado junto al nombre de la pestaña.
• Cambiar las posiciones de las pestañas: cambie las posiciones de las pestañas mediante gestos de arrastrar y colocar.
• Cambiar la conexión de base de datos existente: en Explorador, seleccione la conexión de base de datos existente para abrir el centro de datos.

En el lado derecho de la barra de comandos, hay un menú con acciones adicionales para administrar las distintas pestañas del conjunto de consultas.

Copiar consulta

Es posible que desee copiar y compartir las consultas que cree.

1. En la parte superior de la ventana de consulta, seleccione la pestaña Inicio.

2. En el panel de consulta, seleccione Copiar consulta.

   

   En la tabla siguiente, se describen las diversas opciones para copiar una consulta.

   Acción	Descripción
   Copiar consulta	Copiar el texto de la consulta.
   Link to clipboard (Vincular al Portapapeles)	Copie un vínculo profundo que se pueda usar para ejecutar la consulta.
   Link and query to clipboard (Vincular consulta al Portapapeles)	Copie un vínculo que se pueda usar para ejecutar la consulta y el texto de la consulta.
   Link, query and results to clipboard (Vínculo, consulta y resultados en el Portapapeles)	Copie un vínculo que se pueda usar para ejecutar la consulta, el texto de la consulta y los resultados de la consulta.
   Copiar resultados	Copia los resultados de la consulta.

3. Seleccione la acción deseada en la tabla anterior.

4. Pegue esta información para editarla o compartirla, por ejemplo, en Microsoft Word, Microsoft Teams u Outlook.

   Importante

   El usuario que recibe el vínculo de consulta debe tener permisos de visualización para que los datos subyacentes ejecuten la consulta y muestren los resultados.

Exportar datos de consulta a un archivo .csv

En lugar de simplemente copiar y pegar la salida de la consulta, también puede exportar los resultados de la consulta.

Se trata de un método único para exportar un archivo .csv que contiene los resultados de la consulta.

1. En la parte superior de la ventana de consulta, seleccione la pestaña Inicio.

   

2. En el panel de consulta, seleccione Exportar a CSV.

3. Guarde el archivo .csv localmente.

Eliminar conjunto de consultas KQL

Para eliminar el conjunto de consultas KQL:

1. Seleccione el área de trabajo en la que se encuentra el conjunto de consultas KQL.

2. Mantenga el puntero sobre el conjunto de consultas KQL que quiere eliminar. Seleccione Más [...] y, a continuación, seleccione Eliminar.

   

Paso siguiente

Personalizar resultados en la cuadrícula de resultados del conjunto de consultas KQL