Interroger des données dans un ensemble de requêtes KQL

Dans cet article, vous allez apprendre à utiliser un ensemble de requêtes KQL. L’ensemble de requêtes KQL est l’élément utilisé pour exécuter des requêtes, afficher et personnaliser les résultats des requêtes sur les données d’une base de données KQL.

L'ensemble de requêtes KQL utilise le langage de requête Kusto pour la création de requêtes et prend en charge de nombreuses fonctions SQL. Pour plus d’informations sur le langage de requête, consultez la vue d’ensemble du langage de requête Kusto.

Prérequis

• Un espace de travail avec une capacité compatible Microsoft Fabric
• Une base de données KQL avec des autorisations et des données modifiées, ou un cluster et une base de données Azure Data Explorer avec des autorisations AllDatabaseAdmin.

Sélectionner une base de données

Les requêtes s’exécutent dans le contexte d’une base de données. Vous pouvez modifier la base de données associée à tout moment et conserver les requêtes enregistrées dans l’éditeur de requête. Vous pouvez associer votre ensemble de requêtes KQL à une base de données KQL ou à une base de données à partir d’un cluster Azure Data Explorer.

Sélectionnez l’onglet correspondant au type de base de données souhaité.

Base de données KQL

1. Ouvrez votre ensemble de requêtes KQL.

2. Sous Base de données, sélectionnez V pour développer le menu Connexions de base de données.

   

3. Sous Connecter source, sélectionnez OneLake Data Hub.

4. Dans la fenêtre du hub de données OneLake qui s’affiche, sélectionnez une base de données KQL, puis sélectionnez Sélectionner.

   

Cluster Azure Data Explorer

1. Ouvrez votre ensemble de requêtes KQL.

2. Sous Base de données, sélectionnez V pour développer le menu Connexions de base de données.

   

3. Sous Connecter la source, sélectionnez Azure Data Explorer..

4. Sous Connexion URI, entrez l’URI du cluster.

   Pour rechercher l’URI de connexion, accédez à votre ressource de cluster dans le Portail Azure. L’URI de connexion est l’URI trouvé dans la vue d’ensemble. Pour ajouter un exemple de cluster gratuit, spécifiez « aide » comme Connexion URI.

   

5. Sous Base de données, sélectionnez le menu déroulant pour développer la liste des bases de données dans votre cluster, puis sélectionnez une base de données.

6. Sélectionnez Se connecter.

Une liste des tables associées à cette base de données s’affiche sous le nom de la base de données.

Écrivez votre requête.

Maintenant que vous êtes connecté à votre source de données, vous pouvez exécuter des requêtes sur ces données. L’ensemble de requêtes KQL utilise le langage de requête Kusto (KQL) pour interroger des données à partir de l’une des bases de données à laquelle vous avez accès. Pour en savoir plus sur KQL, consultez Vue d’ensemble du Langage de requête Kusto.

Les exemples suivants utilisent des données disponibles publiquement sur https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Écrivez ou copiez une requête dans le volet supérieur de l’ensemble de requêtes KQL.

2. Sélectionnez le bouton Exécuter ou appuyez sur Maj+Entrée pour exécuter la requête.

   La sortie de requête résultante s’affiche dans la grille des résultats, qui apparaît sous le volet de requête. Notez la marque verte indiquant que la requête s’est terminée avec succès et le temps utilisé pour calculer les résultats de la requête.

   

Gérer les onglets d’un ensemble de requêtes

Dans un ensemble de requêtes KQL, vous pouvez créer plusieurs onglets. Chaque onglet peut être associé à une base de données KQL différente et vous permet d’enregistrer des requêtes pour une utilisation ultérieure ou de les partager avec d’autres personnes afin de collaborer sur l’exploration des données. Vous pouvez également modifier la base de données KQL associée à n’importe quel onglet, ce qui vous permet d’exécuter la même requête sur des données dans différents états.

• Renommer un onglet : sélectionnez l’icône en forme de crayon en regard du nom de l’onglet.
• Ajouter un nouvel onglet : sélectionnez le signe plus + à droite des onglets existants. Différents onglets peuvent être connectés à différentes bases de données.
• Modifier la connexion de base de données existante : sous Base de données, sélectionnez la connexion de base de données existante pour ouvrir le hub de données.

Copier la requête

Vous pouvez copier ou partager les requêtes que vous créez.

1. En haut de la fenêtre Requête, sélectionnez l'onglet Accueil.

2. Sélectionnez Copier la requête.

   

   Le tableau suivant décrit les nombreuses options permettant de partager une requête.

   Important

   L'utilisateur qui reçoit le lien de requête doit disposer des autorisations d'affichage des données sous-jacentes pour exécuter la requête et afficher les résultats.

   Action	Description
   Copier la requête	Copiez le texte de la requête.
   Lien dans le Presse-papiers	Copiez un lien profond qui peut être utilisé pour exécuter la requête.
   Lien et requête dans le presse-papiers	Copiez un lien qui peut être utilisé pour exécuter la requête et le texte de la requête.
   Lien, requête et résultats dans le presse-papiers	Copiez un lien qui peut être utilisé pour exécuter la requête, le texte de la requête et les résultats de la requête.
   Copier les résultats	Copiez les résultats de la requête.

3. Sélectionnez l'action de partage souhaitée dans le tableau ci-dessus.

4. Collez ces informations dans n'importe quel éditeur, tel que Microsoft Word.

Exporter des données de requête au format CSV

Au lieu de simplement copier-coller la sortie de requête, vous pouvez également exporter les résultats de la requête.

Il s’agit d’une méthode unique permettant d’exporter un fichier CSV contenant les résultats de la requête.

1. En haut de la fenêtre Requête, sélectionnez l'onglet Accueil.

   

2. Sélectionner Exporter les résultats au format CSV.

3. Enregistrez le fichier CSV localement.

Supprimer un ensemble de requêtes KQL

Pour supprimer votre ensemble de requêtes KQL :

1. Sélectionnez l’espace de travail auquel votre ensemble de requêtes KQL est associé.

2. Pointez sur l’ensemble de requêtes KQL que vous souhaitez supprimer. Sélectionnez Plus [...], puis Supprimer.

   

Étape suivante

Personnaliser les résultats dans la grille de résultats d’un ensemble de requêtes KQL