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

Dans cet article, vous allez apprendre à utiliser un ensemble de requêtes KQL. Un ensemble de requêtes KQL vous permet d’exécuter des requêtes, d’afficher des résultats et de personnaliser les résultats de requête pour les données provenant de différentes sources, telles qu’un eventhouse ou une base de données KQL.

Vous pouvez également utiliser un ensemble de requêtes KQL pour exécuter des requêtes interservices sur un espace de travail Azure Monitor Log Analytics ou une ressource Application Insights.

L’ensemble de requêtes KQL utilise le langage de requête Kusto (KQL) pour créer des requêtes et prend également 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 avec Microsoft Fabric.
• Une base de données KQL avec des autorisations de modification et d'accès aux données, ou un cluster et une base de données Azure Data Explorer avec des autorisations administratives AllDatabaseAdmin.

Sélectionner une source de données

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

Sélectionnez l’onglet de votre type de source de données.

Une liste de tables associées à cette source de données apparaît sous le nom de la source de données.

Écrivez votre requête.

Maintenant que vous êtes connecté à une source de données, vous pouvez exécuter des requêtes sur celle-ci. Le queryset KQL utilise le langage de requête Kusto (KQL) pour interroger des données depuis toute source de données connectée à 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 l’exemple de fichierStormEvents.csv public.

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.

   Les résultats de la requête s’affichent dans la grille des résultats sous le volet de requête. Remarquez la coche verte indiquant que la requête s’est terminée avec succès, ainsi que le temps utilisé pour calculer les résultats de la requête.

   

Interagir avec les sources de données

L’Explorateur de sources de données vous permet de basculer entre les sources de données connectées à l’onglet jeu de requêtes actuel.

En haut du volet explorateur de sources de données, sous Explorateur, vous pouvez utiliser la barre de recherche pour rechercher une source de données spécifique. Vous pouvez également utiliser le sélecteur de base de données sous la barre de recherche pour développer le menu Connexions de source de données. Sélectionnez la source de données que vous souhaitez utiliser. Si vous n’avez pas renommé l’onglet précédemment, il est automatiquement nommé après la source de données.

Le volet Explorateur de sources de données comporte deux sections. La section supérieure répertorie tous les éléments de la source de données, et la section inférieure affiche toutes les sources de données disponibles dans l’ensemble de requêtes.

Afficher les éléments dans la source de données

La section supérieure de l’Explorateur de sources de données affiche tous les éléments de la source de données que vous utilisez.

• Tableaux
• Vues matérialisées
• Raccourcis
• Fonctions

Sélectionnez la flèche > à gauche de l’élément que vous souhaitez développer. Vous pouvez explorer pour afficher plus de détails en sélectionnant la flèche > à gauche des éléments dans les niveaux de liste suivants. Par exemple, sous Tables, sélectionnez la flèche > à gauche d’une table pour afficher la liste des colonnes de cette table.

Pour ouvrir le menu d’action, pointez sur un élément de la liste développée et sélectionnez le menu Plus [...]. Le menu inclut les options suivantes :

• Actualiser la base de données
• Afficher le profil de données
• Explorer des données
• Insertion : pour créer et copier un script
• Obtenir des données : pour ajouter une nouvelle source de données
• Créer un tableau de bord
• Supprimer une table

Différentes actions sont disponibles pour différents types d’éléments.

Parcourir les sources de données disponibles

La section inférieure de l’Explorateur de sources de données affiche toutes les sources de données disponibles que vous ajoutez à l’ensemble de requêtes.

Pour ouvrir le menu action, pointez sur le nom de la source de données et sélectionnez le menu Plus [...]. Le menu inclut les options suivantes :

• Actualiser la base de données
• Utilisez cette base de données : passez à cette source de données dans l'onglet actuel.
• Requête dans un nouvel onglet : ouvrez cette source de données dans un nouvel onglet dans l’ensemble de requêtes
• Supprimer la source : supprime toutes les bases de données de cette source de données
• Supprimer la base de données : supprime la base de données sélectionnée uniquement
• Ouvrir dans la base de données KQL : ouvre cette source de données dans une base de données KQL.

Gérer les onglets du jeu 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. Cette configuration vous permet d’enregistrer des requêtes pour une utilisation ultérieure ou de les partager avec d’autres personnes pour 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 les données dans différentes bases de données.

Vous pouvez gérer vos onglets de la manière suivante :

• Modifier la connexion de source de données existante: sous l'explorateur et la barre de recherche, utilisez le commutateur de base de données pour étendre le menu des connexions de sources de données.
• Renommer un onglet: en regard du nom de l’onglet, sélectionnez l’icône de crayon .
• Ajouter un nouvel onglet: à droite des onglets existants dans la barre de commandes, sélectionnez le +plus . Différents onglets peuvent être connectés à différentes sources de données.
• Autres actions : sur le côté droit de la barre de commandes, utilisez le menu onglet pour gérer plusieurs onglets dans votre ensemble de requêtes.
• Modifier les positions des onglets: utilisez des mouvements de glisser-déplacer.

Supprimer un ensemble de requêtes KQL

Pour supprimer votre ensemble de requêtes KQL :

1. Sélectionnez l’espace de travail qui contient votre jeu de requêtes KQL.

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

   

Étape suivante