Remarque
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.
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
Kusto.Explorer est un outil de bureau Windows gratuit. Utilisez-le pour interroger et analyser des données avec Kusto Query Language (KQL) dans une interface conviviale. Cet article explique comment configurer Kusto.Explorer et son interface utilisateur.
Utilisez Kusto.Explorer pour :
- Interroger vos données
- Rechercher vos données dans plusieurs tables.
- Visualisez vos données dans des graphiques.
- Partagez des requêtes et des résultats par e-mail ou lien profond.
Installer Kusto.Explorer
Téléchargez et installez Kusto.Explorer à partir de :
Vous pouvez également utiliser un navigateur compatible ClickOnce pour accéder à votre cluster Kusto à l’adresse suivante :
https://<your_cluster>/?web=0Remplacez l’espace<your_cluster>réservé par votre URI de cluster (par exemple,help.kusto.windows.net).
Utiliser Google Chrome avec Kusto.Explorer
Si Google Chrome est votre navigateur par défaut, installez l’extension ClickOnce. Extension ClickOnce pour Chrome
Si Microsoft Edge est votre navigateur par défaut, vous n’avez pas besoin de cette extension. Vérifiez les paramètres ClickOnce dans les indicateurs Microsoft Edge.
Vue d’ensemble de l’interface utilisateur
Kusto.Explorer utilise des onglets et des panneaux :
- Utilisez le panneau de menus pour effectuer des tâches.
- Gérez les connexions dans le panneau connexions.
- Créez et exécutez des scripts dans le panneau de script.
- Affichez les résultats du script dans le volet de résultats.
Panneau Connexions
Le panneau Connexions répertorie toutes les connexions de cluster configurées. Pour chaque cluster, il répertorie les bases de données, les tables et les colonnes. Sélectionnez un élément pour définir le contexte de la recherche ou de la requête dans le volet principal. Pour copier un nom dans le volet de recherche ou de requête, double-cliquez sur l’élément.
Si le schéma est volumineux (par exemple, une base de données avec des centaines de tables), sélectionnez Ctrl+F et entrez une partie insensible à la casse du nom de l’entité à rechercher.
Contrôlez le panneau Connexions à partir de la fenêtre de requête pour prendre en charge les flux de travail scriptés. Démarrez le script avec une commande qui indique à Kusto.Explorer de se connecter au cluster et à la base de données que le script interroge :
#connect cluster('help').database('Samples')
StormEvents | count
Exécutez chaque ligne avec F5.
Volet Documents de travail
Le volet Dossiers de travail organise vos dossiers de travail pour une navigation rapide. Il comprend deux types :
- Travail non enregistré : Dossiers pour les onglets de requête ouverts que vous modifiez toujours
- Dossiers suivis : dossiers d’appareils que vous ajoutez en tant que bibliothèques KQL pour faciliter l’accès et la gestion
Panneau de menu
Onglet Accueil
L’onglet Accueil affiche les opérations les plus fréquemment utilisées. Il inclut :
Section Requête
| Menu | Comportement |
|---|---|
| Liste déroulante Mode |
|
| Nouvel onglet | Ouvre un nouvel onglet de requête pour le langage de requête Kusto (KQL). |
Partager la section
| Menu | Comportement |
|---|---|
| Données dans le presse-papiers | Copie la requête et le jeu de données dans le presse-papiers. Si un graphique est affiché, copie également le graphique en tant que bitmap. |
| Résultat dans le presse-papiers | Copie le jeu de données dans le Presse-papiers. Si un graphique est affiché, copie également le graphique en tant que bitmap. |
| Requête dans le presse-papiers | Copie la requête dans le Presse-papiers. |
Section Visualisations
Pour plus d’options de visualisation, consultez l’opérateur de rendu.
| Menu | Comportement |
|---|---|
| Graphique en aires | Affiche un graphique en aires où la première colonne (numérique) est l’axe X. Mappe chaque colonne numérique à une série d’axes Y distincte. |
| Graphique en histogrammes | Affiche un histogramme où toutes les colonnes numériques sont mappées à différentes séries (axe Y). La colonne de texte avant numérique est l’axe X (peut être contrôlé dans l’interface utilisateur). |
| Graphique en barres | Affiche un graphique à barres où toutes les colonnes numériques sont mappées à différentes séries (axe X). La colonne de texte avant numérique est l’axe Y (peut être contrôlé dans l’interface utilisateur). |
| Graphique en aires empilées | Affiche un graphique en aires empilées dans lequel l’axe X est la première colonne (doit être numérique). Toutes les colonnes numériques sont mappées vers des séries différentes (axe Y). |
| Graphique Heure | Affiche un graphique d’heure dans lequel l’axe X est la première colonne (doit être datetime). Toutes les colonnes numériques sont mappées vers des séries différentes (axe Y). |
| Graphique en courbes | Affiche un graphique en courbes dans lequel l’axe X est la première colonne (doit être numérique). Toutes les colonnes numériques sont mappées vers des séries différentes (axe Y). |
| Graphique d’anomalies | Similaire au graphique chronologique, mais détecte les anomalies dans les données de série chronologique à l’aide d’un algorithme Machine Learning. Les données doivent utiliser des compartiments à intervalle fixe. Pour la détection d’anomalies, Kusto.Explorer utilise la fonction series_decompose_anomalies. |
| Graphique à secteurs | Affiche un graphique en secteurs dans lequel l’axe des couleurs est la première colonne. L’axe des thêta (doit être une mesure, convertie en pourcentage) est la deuxième colonne. |
| Échelle de temps | Affiche un graphique en échelle dans lequel l’axe X correspond aux deux dernières colonnes (doit être datetime). L’axe des Y est un composite des autres colonnes. |
| Graphique à nuages de points | Affiche un graphique de points dans lequel l’axe X est la première colonne (doit être numérique). Toutes les colonnes numériques sont mappées vers des séries différentes (axe Y). |
| Graphique croisé dynamique | Affiche un tableau croisé dynamique et un graphique qui vous permet de sélectionner des données, des colonnes, des lignes et des types de graphiques. |
| Tableau croisé dynamique Time | Vous permet de parcourir la chronologie des événements de manière interactive (pivots sur l’axe horaire). |
Section d’affichage
| Menu | Comportement |
|---|---|
| Mode d’affichage complet | Optimise l’espace de travail en masquant le menu du ruban et le panneau de connexion. Quittez le mode d’affichage complet en sélectionnant Accueil>Mode d’affichage complet ou en appuyant sur F11. |
| Masquer les colonnes vides | Supprime les colonnes vides de la grille de données. |
| Réduire les colonnes singulières | Réduit les colonnes avec des valeurs singulières. |
| Explorer les valeurs de colonne | Affiche la distribution des valeurs de colonne. |
| Augmenter la police | Augmente la taille de police dans l’onglet requête et la grille des résultats. |
| Réduire la taille de police | Diminue la taille de police dans l’onglet requête et la grille des résultats. |
Remarque
Paramètres de la vue des données :
Kusto.Explorer effectue le suivi des paramètres pour chaque ensemble unique de colonnes. Lorsque vous réorganisez ou supprimez des colonnes, elle enregistre la vue de données et la réutilise lorsque vous récupérez des données avec les mêmes colonnes. Pour réinitialiser l’affichage à ses valeurs par défaut, sous l’onglet Affichage , sélectionnez Réinitialiser l’affichage.
Onglet Fichier
| Menu | Comportement |
|---|---|
| Script de requête | |
| Nouvel onglet | Ouvre une nouvelle fenêtre d’onglet pour interroger Kusto. |
| Ouvrir un fichier | Charge un script .kql dans le volet de requête actif. |
| Enregistrer dans le fichier | Enregistre le script actif dans un fichier .kql. |
| Fermer l'onglet | Ferme l’onglet actif. |
| Profiles | |
| Profil d’importation | Importe un profil Kusto.Explorer. |
| Exporter le profil | Exporte un profil Kusto.Explorer. |
| Enregistrer des données | |
| Données au format CSV | Exporte des données vers un fichier CSV (séparés par des virgules). |
| Données au format JSON | Exporte des données dans un fichier au format JSON. |
| Données vers Excel | Exporte des données dans un fichier XLSX (Excel). |
| Données en texte | Exporte des données dans un fichier TXT (texte). |
| Données vers un script KQL | Exporte la requête dans un fichier de script. |
| Données vers résultats | Exporte la requête et les données dans un fichier de résultats (QRES). |
| Exécuter la requête au format CSV | Exécute la requête et enregistre les résultats dans un fichier CSV local. |
| Charger des données | |
| À partir des résultats | Charge la requête et les données à partir d’un fichier de résultats (QRES). |
| Presse-papiers | |
| Requête et résultats dans le presse-papiers | Copie la requête et le jeu de données dans le presse-papiers. Si un graphique est affiché, copie le graphique en tant que bitmap. |
| Résultat dans le presse-papiers | Copie le jeu de données dans le Presse-papiers. Si un graphique est affiché, copie le graphique en tant que bitmap. |
| Requête dans le Presse-papiers | Copie la requête dans le Presse-papiers. |
| Résultats dans le Presse-papiers (datatable()) | Copie les résultats de la requête dans le presse-papiers. La valeur maximale autorisée de la cellule est de 30 000. |
| Résultats | |
| Effacer le cache des résultats | Efface les résultats mis en cache des requêtes exécutées précédemment. |
Onglet Connexions
| Menu | Comportement |
|---|---|
| Groupes | |
| Ajout d’un groupe | Ajoutez un groupe de serveurs Kusto. |
| Clusters | |
| Importer des connexions | Importer des connexions à partir d’un fichier. |
| Exporter les connexions | Exportez les connexions vers un fichier. |
| Ajouter une connexion | Ajoutez une connexion de serveur Kusto. |
| Modifier la connexion | Ouvrez la boîte de dialogue propriétés de connexion. |
| Supprimer la connexion | Supprimez la connexion du serveur Kusto. |
| Actualiser | Actualisez les propriétés de connexion. |
| Profiles | |
| Profil d’importation | Importez un profil Kusto.Explorer. |
| Exporter le profil | Exportez un profil Kusto.Explorer. |
| Sécurité | |
| Inspecter votre principal AAD | Afficher les détails actuels de l’utilisateur connecté. |
| Déconnexion | Déconnectez l’utilisateur actuel de l’ID Microsoft Entra. |
| Étendue des données | |
| Étendue de la mise en cache |
|
| Colonne DateHeure | Nom d’une colonne que vous pouvez utiliser pour un préfiltre de temps. |
| Filtre de temps | Valeur du préfiltre de temps. |
Onglet Affichage
| Menu | Comportement |
|---|---|
| Apparence | |
| Mode d’affichage complet | Maximise l’espace de travail en masquant le menu de ruban et le panneau de connexion. Quittez le mode Accueil>Mode Plein écran ou en appuyant sur **F11 . |
| Agrandir la police | Augmente la taille de police de l’onglet requête et de la grille de données des résultats. |
| Réduire la police | Diminue la taille de police de l’onglet requête et de la grille de données des résultats. |
| Rétablir la disposition | Réinitialise la disposition et les fenêtres d’ancrage. |
| Renommer l’onglet Document | Renomme l’onglet sélectionné. |
| Vue de données | |
| Réinitialiser l’affichage | Réinitialise les paramètres de vue de données à leurs valeurs par défaut. |
| Explorer les valeurs de colonne | Affiche la distribution des valeurs de colonne. |
| Focus sur les statistiques de requête | Affiche les statistiques de requête au lieu des résultats lorsque la requête se termine. |
| Masquer les doublons | Active/désactive la suppression des lignes dupliquées des résultats. |
| Masquer les colonnes vides | Supprime les colonnes vides des résultats. |
| Réduire les colonnes singulières | Rétracte les colonnes qui contiennent une valeur unique. |
| Sélection de lignes | Active la sélection de lignes spécifiques dans le volet Résultats. |
| Couleur par colonne | Colore les valeurs identiques dans la première colonne. |
| Renvoyer à la ligne automatiquement | Encapsule le contenu des cellules pour qu’il corresponde à la largeur de colonne. |
| Filtrage des données | |
| Filtrer les lignes dans la recherche | Affiche uniquement les lignes correspondantes lorsque vous effectuez une recherche ( Ctrl+F ). |
| Visualisations | |
| Visualisations | Consultez Visualisations. |
Remarque
Paramètres de l’affichage de données :
Kusto.Explorer effectue le suivi des paramètres par ensemble unique de colonnes. Lorsque vous réorganisez ou supprimez des colonnes, elle enregistre la vue de données et la réutilise lorsqu’elle récupère des données avec les mêmes colonnes. Pour réinitialiser les valeurs par défaut, sous l’onglet Affichage , sélectionnez Réinitialiser l’affichage.
Onglet Outils
| Menu | Comportement |
|---|---|
| IntelliSense | |
| Activer IntelliSense | Active ou désactive IntelliSense dans le panneau Script. |
| Liste des problèmes | Répertorie les problèmes dans le panneau Script. |
| Automation | |
| Ajouter une nouvelle automatisation | Génère un rapport avec des analyses des requêtes. |
| Services publics | |
| Outils de ligne de commande | Ouvre une invite de commandes. |
| Compresser le fichier LZ4 | Compresse des fichiers avec l’algorithme LZ4. |
| Décompresser le fichier LZ4 | Décompose les fichiers avec l’algorithme LZ4. |
| Analytics | |
| Rapports analytiques | Ouvre un tableau de bord avec des rapports d’analyse de données prédéfinis. |
| Traduire | |
| Requête dans Power BI | Convertit une requête au format Power BI. |
| Envoi de requête à WPA | Convertit une requête au format WPA. |
| Requête à WPA (Presse-papiers) | Convertit une requête au format WPA et la copie dans le presse-papiers. |
| Options | |
| Réinitialiser les options | Réinitialise les paramètres de l’application aux valeurs par défaut. |
| Options | Ouvre l’outil d’options pour configurer les paramètres de l’application. Pour plus d’informations, consultez les options Kusto.Explorer. |
Couleurs des lignes de tableau
Kusto.Explorer interprète le niveau de gravité ou de détail de chaque ligne dans le volet de résultats et colorie les lignes en conséquence. Il associe les valeurs distinctes des colonnes à des modèles connus (par exemple, « Avertissement », « Erreur »).
Pour modifier le jeu de couleurs du résultat ou désactiver ce comportement, sélectionnez Outils>Options>Visionneuse de résultats>Modèle de couleurs de verbosité.
| Légende du jeu de couleurs Excel | Légende du jeu de couleurs vives |
|---|---|
|
|
Onglet Analyse
| Menu | Comportement |
|---|---|
| Monitor | |
| Diagnostics de cluster | Affiche un résumé d’intégrité pour le groupe de serveurs actuellement sélectionné dans le volet Connexions. |
| Données les plus récentes : toutes les tables | Affiche un résumé des données les plus récentes dans toutes les tables de la base de données actuellement sélectionnée. |
| Données les plus récentes : table sélectionnée | Affiche les données les plus récentes pour la table sélectionnée dans la barre d’état. |
Onglet Gestion
| Menu | Comportement |
|---|---|
| Principaux habilités | |
| Gérer les principaux autorisés de la base de données | Permet aux utilisateurs autorisés de gérer les entités principales de la base de données. |
| Gérer les principaux autorisés de la table | Permet aux utilisateurs autorisés de gérer les principaux de table. |
| Gérer les principaux autorisés de la fonction | Permet aux utilisateurs autorisés de gérer les identifiants de fonction. |
Onglet Aide
| Menu | Comportement |
|---|---|
| Documentation | |
| Aide | Ouvre la documentation en ligne Kusto. |
| Nouveautés | Ouvre les notes de publication kusto.Explorer. |
| Raccourcis clavier | Ouvre les raccourcis clavier Kusto.Explorer. |
| Afficher le CLUF | Ouvre l’article Informations juridiques Microsoft Azure. |
| Support et commentaires | |
| Rapport d'incident | Ouvre une boîte de dialogue avec deux options : . |
| Suggérer une fonctionnalité | Ouvre une page pour partager vos idées. |
| Kusto Support (KAI Bot) | Ouvre KAI pour l'autoservice, l'orientation proactive et la résolution autonome des problèmes. |
Contrôler l’identité de l’utilisateur qui se connecte à Kusto.Explorer
Le modèle de sécurité par défaut pour les nouvelles connexions est la sécurité fédérée microsoft Entra ID. L’authentification utilise l’ID Microsoft Entra avec l’expérience de connexion Microsoft Entra par défaut.
Pour un contrôle plus fin sur les paramètres d’authentification, développez la zone Avancé : Chaînes de connexion et entrez une chaîne de connexion Kusto valide.
Par exemple, les utilisateurs de plusieurs locataires Microsoft Entra doivent parfois sélectionner une identité spécifique dans un locataire cible. Utilisez la chaîne de connexion pour la spécifier. Remplacez les valeurs d’espace réservé entre crochets par vos propres valeurs :
Data Source=https://<ClusterName>.kusto.windows.net;Initial Catalog=<DatabaseName>;AAD Federated Security=True;Authority Id=<TenantId>;User=<UserIdentity>
-
<TenantId>est le nom de domaine ou l’ID de locataire Microsoft Entra (GUID) du locataire qui héberge le cluster (par exemple, contoso.com). -
<UserIdentity>est l'identité utilisateur invitée dans ce client (par exemple, user@example.com).
Remarque
Le nom de domaine de l’utilisateur peut différer du locataire qui héberge le cluster.
