Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 de données, telles que Eventhouse, la base de données KQL, etc.
Vous pouvez également utiliser un ensemble de requêtes KQL pour effectuer des requêtes interservices avec des données à partir d’un espace de travail Log Analytics Azure Monitor ou d’une ressource Application Insights.
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 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 sources de données de différents types, notamment une base de données KQL, un cluster Azure Data Explorer ou Azure Monitor.
Sélectionnez l’onglet correspondant au type de source de données souhaité.
Dans le volet Explorateur , sous la barre de recherche, ouvrez le sélecteur
de base de données, puis sélectionnez Ajouter une source>de données Eventhouse / KQL Database.
Dans la fenêtre de catalogue OneLake qui s’affiche, sélectionnez une base de données KQL pour vous connecter à votre requête 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 menu Plus [...]. Le menu affiche 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.
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 menu Plus [...]. 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
- 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 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.
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.
