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 des données provenant de différentes sources, comme Eventhouse, la base de données KQL, etc.
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 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 sources de données de différents types, notamment une base de données KQL ou une source de données à partir d’un cluster Azure Data Explorer.
Sélectionnez l’onglet correspondant au type de source de données souhaité.
Dans le volet situé à gauche de la page de requête, sous Explorateur et la barre de recherche, utilisez le sélecteur de base de données pour ouvrir le menu des connexions de sources de données.
Sélectionnez Ajouter une source de données, puis sélectionnez hub de données OneLake.
Dans la fenêtre du hub de données OneLake qui s’affiche, sélectionnez une base de données KQL pour vous connecter à votre ensemble de requêtes KQL, puis sélectionnez Connecter. Vous pouvez également fermer la fenêtre hub de données OneLake et utiliser le menu + Ajouter une source de données pour vous connecter à une autre 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é à 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 sources de données auxquelles 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.
Écrivez ou copiez une requête dans le volet supérieur de l’ensemble de requêtes KQL.
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. 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 dans lequel vous vous trouvez.
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 le nom de l’onglet n’a pas été modifié 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.
Éléments de la source de données
La section supérieure de l’Explorateur de sources de données affiche tous les éléments inclus dans la source de données que vous utilisez.
- Tables
- Vue matérialisée
- 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 Autres actions menu [...]. Le menu affiche les options suivantes :
- Actualiser la base de données
- Afficher le profil de 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.
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 qui ont été ajoutées à l’ensemble de requêtes.
Pour ouvrir le menu action, pointez sur le nom de la source de données et sélectionnez le Autres actions menu [...]. Le menu affiche 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
Copier la requête
Vous pouvez copier et partager les requêtes que vous créez.
En haut de la fenêtre Requête, sélectionnez l'onglet Accueil.
Dans le volet de requête, sélectionnez Copier la requête.
Le tableau suivant décrit les nombreuses options permettant de copier une requête.
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. Sélectionnez l’action souhaitée dans la liste.
Collez ces informations pour les modifier ou les partager, par exemple dans Microsoft Word, Microsoft Teams ou Outlook.
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.
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 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, il existe un menu onglet avec plus d’actions pour gérer les plusieurs onglets de votre ensemble de requêtes.
- Modifier les positions des onglets: utilisez des mouvements de glisser-déplacer.
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.
En haut de la fenêtre Requête, sélectionnez l'onglet Accueil.
Dans le volet de requête, sélectionnez Exporter au format CSV.
Enregistrez le fichier CSV localement.
Supprimer un ensemble de requêtes KQL
Pour supprimer votre ensemble de requêtes KQL :
Sélectionnez l’espace de travail dans lequel se trouve votre ensemble de requêtes KQL.
Pointez sur l’ensemble de requêtes KQL que vous souhaitez supprimer. Sélectionnez Plus [...], puis Supprimer.
