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 una base de datos KQL.

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. Puedes asociar el conjunto de consultas KQL a una base de datos KQL o una base de datos desde 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 Base de datos, selecciona 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 del centro de datos de OneLake que aparece, selecciona una base de datos KQL y, a continuación, selecciona Seleccionar.

   

Clúster de Azure Data Explorer

1. Abre el conjunto de consultas KQL.

2. En Base de datos, selecciona 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.

Una lista de tablas asociadas a esta base de datos aparecerá debajo del nombre de la base de datos.

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 ha finalizado 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.

• Cambiar el nombre de una pestaña: seleccione el icono de lápiz situado junto al nombre de la pestaña.
• 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 la conexión de base de datos existente: en Base de datos, seleccione la conexión de base de datos existente para abrir el centro de datos.

Copiar consulta

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

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

2. Seleccione Copiar consulta.

   

   En la tabla siguiente se describen las numerosas opciones para compartir una consulta.

   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.

   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 de uso compartido deseada en la tabla anterior.

4. Pegue esta información en cualquier editor, como Microsoft Word.

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

   

2. Seleccione Exportar los resultados a un archivo. 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 a la que está asociado 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