Share via

Utilisation de Kusto.Explorer

  • Article

Kusto. Explorer est une application de bureau qui vous permet d’explorer vos données à l’aide de la Langage de requête Kusto dans une interface utilisateur facile à utiliser. Cet article vous montre comment utiliser les modes de recherche et de requête, partager vos requêtes et gérer des clusters, des bases de données et des tables.

Mode Recherche++

Le mode Recherche++ vous permet de rechercher un terme à l’aide de la syntaxe de recherche dans une ou plusieurs tables.

  1. Dans la liste déroulante Requête de l’onglet Accueil , sélectionnez Rechercher++.

  2. Sélectionnez Plusieurs tables.

  3. Sous Choisir des tables, définissez les tables à rechercher, puis sélectionnez OK.

  4. Dans la zone d’édition, entrez votre expression de recherche, puis sélectionnez Ok.

    Une carte thermique de la grille de tables/créneaux horaires indique les termes qui s’affichent et où ils apparaissent.

    Rechercher + + Kusto Explorer

  5. Sélectionnez une cellule dans la grille et sélectionnez Afficher les détails pour afficher les entrées pertinentes dans le volet de résultats.

    Kusto Explorer Search + + results

mode Requête

Kusto. Explorer inclut un mode de requête puissant qui vous permet d’écrire, de modifier et d’exécuter des requêtes inline. Le mode de requête est fourni avec la mise en surbrillance de la syntaxe et IntelliSense, ce qui vous permet d’accélérer rapidement vos connaissances des Langage de requête Kusto.

Cette section explique comment exécuter des requêtes de base dans Kusto. Explorer et comment ajouter des paramètres à vos requêtes.

Requêtes de base

Si vous avez des journaux de table, vous pouvez commencer à les explorer :

StormEvents | count

Lorsque votre curseur se trouve sur cette ligne, il est de couleur grise. Appuyez sur F5 pour exécuter la requête.

Voici quelques autres exemples de requêtes :

// Take 10 lines from the table. Useful to get familiar with the data
StormEvents | take 10 

// Filter by EventType == 'Flood' and State == 'California' (=~ means case insensitive) 
// and take sample of 10 lines
StormEvents 
| where EventType == 'Flood' and State =~ 'California'
| take 10

Kusto Explorer requête de base.

Pour en savoir plus sur les Langage de requête Kusto, consultez Langage de requête Kusto.

Notes

Des lignes vides dans l’expression de requête peuvent avoir une incidence sur la partie de la requête qui est exécutée.

Si aucun texte n’est sélectionné, l’hypothèse est que la requête ou la commande est séparée par des lignes vides. Si du texte est sélectionné, le texte sélectionné est exécuté.

Paramétrage des requêtes côté client

Notes

Il existe deux types de techniques de paramétrage de requête dans Kusto :

  • La paramétrisation des requêtes intégrées au langage est implémentée côté serveur et est destinée à être utilisée par les applications qui interrogent le service par programmation. Cette méthode n’est pas décrite dans ce document.

  • La paramétrisation des requêtes côté client, décrite ci-dessous, est une fonctionnalité de Kusto. Explorer application uniquement. Cela revient à utiliser des opérations de remplacement de chaîne sur les requêtes avant de les envoyer à exécuter par le service. La syntaxe décrite ci-dessous ne fait pas partie du langage de requête lui-même et ne peut pas être utilisée lors de l’envoi de requêtes au service par des moyens autres que Kusto. Explorer.

Si vous utilisez la même valeur dans plusieurs requêtes ou dans plusieurs onglets, il est très peu pratique de modifier cette valeur à chaque endroit où elle est utilisée. C’est pour ça que Kusto. Explorer prend en charge les paramètres de requête. Les paramètres de requête sont partagés entre les onglets afin qu’ils puissent être facilement réutilisés. Les paramètres sont indiqués par {} des crochets. Par exemple : {parameter1}.

Vous pouvez facilement définir et modifier des paramètres de requête existants :

Capture d’écran de l’éditeur de requête montrant une requête avec des paramètres. L’option de l’éditeur de requête intitulée Paramètres de requête est mise en surbrillance.

Capture d’écran de la fenêtre Paramètres de requête montrant les paramètres définis.

Vous pouvez avoir plusieurs ensembles de paramètres (répertoriés dans la zone de liste déroulante Ensemble de paramètres ). Sélectionnez Ajouter nouveau ou Supprimer actuel pour manipuler la liste des jeux de paramètres.

Liste des jeux de paramètres.

Partager des requêtes et des résultats

À Kusto. Explorer, vous pouvez partager des requêtes et des résultats par e-mail. Vous pouvez également créer des liens profonds qui ouvrent et exécutent une requête dans le navigateur.

Partager des requêtes et des résultats par e-mail

Kusto. Explorer fournit un moyen pratique de partager des requêtes et des résultats de requête par e-mail.

  1. Exécutez votre requête dans Kusto. Explorer.

  2. Sous l’onglet Accueil, dans la section Partager, sélectionnez Requête et résultats dans le Presse-papiers (ou appuyez sur Ctrl+Maj+C).

    Exporter dans le Presse-papiers.

    Kusto. Explorer copie les éléments suivants dans le Presse-papiers :

    • Votre requête
    • Résultats de la requête (tableau ou graphique)
    • Détails de connexion pour le cluster et la base de données Kusto
    • Lien qui réexécuter la requête automatiquement

  3. Collez le contenu du Presse-papiers dans un nouveau message électronique.

    Partagez les résultats par e-mail.

Requêtes de liaison approfondie

Vous pouvez créer un URI qui, lorsqu’il est ouvert dans un navigateur, ouvre Kusto. Explorer localement et exécute une requête spécifique sur une base de données Kusto spécifiée.

Notes

Pour des raisons de sécurité, la liaison approfondie est désactivée pour les commandes de gestion.

Le moyen le plus simple de créer un lien profond consiste à créer votre requête dans Kusto. Explorer, puis utilisez Export to Clipboard pour copier la requête (y compris le lien profond et les résultats) dans le Presse-papiers. Vous pouvez ensuite le partager par e-mail.

Lorsqu’il est copié dans un e-mail, le lien profond s’affiche dans une petite police. Par exemple :

https://help.kusto.windows.net/Samples [Exécuter la requête]

Le premier lien ouvre Kusto. Explorer et définit correctement le contexte du cluster et de la base de données. Le deuxième lien (Run the query) est le lien profond. Si vous déplacez le lien vers un e-mail et appuyez sur Ctrl+K, vous pouvez voir l’URL réelle :

https://help.kusto.windows.net/Samples?web=0& query=H4sIAAAAAAAEAAsuyS%2fKdS1LzSspVuDlqlEoLs3NTSzKrEpVSM4vzSvR0FRIqlRIyszTCC5JLCoJycxN1VEwT9EEKS1KzUtJLVIoAYolZwAlFQCB3oo%2bTAAAAA%3d%3d

Vous pouvez utiliser des requêtes paramétrées avec une liaison approfondie.

  1. Créer une requête à former en tant que requête paramétrable (par exemple, KustoLogs | where Timestamp > ago({Period}) | count)

  2. Fournissez un paramètre pour chaque paramètre de requête dans l’URI, par exemple :

    https://<your_cluster>.kusto.windows.net/MyDatabase? web=0&query=KustoLogs+%7c+where+Timestamp+>+ago({Period})+%7c+count&Period=1h

    Remplacez <your_cluster> par le nom de votre cluster Azure Data Explorer.

Limites

Les requêtes sont limitées à environ 2 000 caractères en raison des limitations du navigateur, des proxys HTTP et des outils qui valident les liens, tels que Microsoft Outlook. La limitation est approximative, car elle dépend du cluster et de la longueur du nom de la base de données. Pour plus d’informations, consultez https://support.microsoft.com/kb/208427.

Pour réduire les chances d’atteindre la limite de caractères, consultez Obtention de liens plus courts.

Le format de l’URI est le suivant : https://<ClusterCname>.kusto.windows.net/<DatabaseName>web=0?query=<QueryToExecute>

Par exemple : https://help.kusto.windows.net/Samples?web=0query=StormEvents+%7c+limit+10

Cet URI ouvre Kusto. Explorer, connectez-vous au Help Cluster Kusto et exécutez la requête spécifiée sur la Samples base de données. S’il existe une instance de Kusto.Explorer déjà en cours d’exécution, le instance en cours d’exécution ouvre un nouvel onglet et exécute la requête qu’il contient.

Les requêtes peuvent devenir longues. Pour réduire le risque que la requête dépasse la longueur maximale, utilisez la méthode disponible dans la String Kusto.Data.Common.CslCommandGenerator.EncodeQueryAsBase64Url(string query) bibliothèque cliente Kusto. Cette méthode produit une version plus compacte de la requête. Le format plus court est également reconnu par Kusto. Explorer.

https://help.kusto.windows.net/Samples?web=0& query=H4sIAAAAAAAEAAsuyS%2fKdS1LzSspVuDlqlEoLs3NTSzKrEpVSM4vzSvR0FRIqlRIyszTCC5JLCoJycxN1VEwT9EEKS1KzUtJLVIoAYolZwAlFQCB3oo%2bTAAAAA%3d%3d

La requête est rendue plus compacte en appliquant la transformation suivante :

 UrlEncode(Base64Encode(GZip(original query)))

Kusto. Explorer arguments de ligne de commande

Les arguments de ligne de commande sont utilisés pour configurer l’outil afin d’effectuer des fonctions supplémentaires au démarrage. Par exemple, chargez un script et connectez-vous à un cluster. Par conséquent, les arguments de ligne de commande ne remplacent pas Kusto. Explorer fonctionnalité.

Les arguments de ligne de commande sont passés dans le cadre de l’URL utilisée pour ouvrir l’application, de la même manière que pour interroger la liaison approfondie.

Syntaxe de l’argument de ligne de commande

Kusto. Explorer prend en charge plusieurs arguments de ligne de commande dans la syntaxe suivante (l’ordre est important) :

[LocalScriptFile] [QueryString]

  • LocalScriptFile est le nom d’un fichier de script sur votre ordinateur local, qui doit avoir l’extension .kql. S’il existe un tel fichier, Kusto. Explorer charge automatiquement ce fichier au démarrage.
  • QueryString est une chaîne qui utilise la mise en forme de chaîne de requête HTTP. Cette méthode fournit des propriétés supplémentaires, comme décrit dans le tableau ci-dessous.

Par exemple, pour démarrer Kusto. Explorer avec un fichier de script appelé c:\temp\script.kql et configuré pour communiquer avec le cluster help, la base de données Samples, utilisez la commande suivante :

Kusto.Explorer.exe c:\temp\script.kql uri=https://help.kusto.windows.net/Samples;Fed=true&name=Samples
Argument Description
Requête à exécuter
query Requête à exécuter (gzipped, puis encodée en base64 ; consultez « Obtention de liens plus courts » ci-dessus). S’il est vide, utilisez querysrc.
querysrc URL HTTP d’un fichier/objet blob contenant la requête à exécuter (si query est vide).
Connexion au cluster Kusto
uri Chaîne de connexion du cluster Kusto auquel se connecter.
name Nom d’affichage de la connexion au cluster Kusto.
Groupe de connexions
path URL d’un fichier de groupe de connexions à télécharger (encodé en URL).
group Nom du groupe de connexions.
filename Fichier local contenant le groupe de connexions.

Gérer des bases de données, des tables ou des principaux de fonction autorisés

Important

Seuls les administrateurs peuvent ajouter ou supprimer des principaux autorisés dans leur propre étendue.

  1. Pour afficher la liste des principaux autorisés, cliquez avec le bouton droit sur l’entité cible dans le panneau Connexions, puis sélectionnez Gérer les principaux autorisés de base de données. (Vous pouvez également sélectionner cette option dans le menu Gestion.)

    Capture d’écran du menu déroulant entité. Les options intitulées Gérer les principaux autorisés de base de données sont mises en surbrillance.

  2. Sélectionnez Ajouter un principal pour ajouter un principal autorisé. Capture d’écran de la fenêtre Gérer les principaux autorisés. Les options intitulées Supprimer le principal et Ajouter un principal sont mises en surbrillance.

  3. Fournissez les détails du principal, puis sélectionnez Ajouter un principal.

    Capture d’écran de la fenêtre Ajouter un principal autorisé. Le bouton intitulé Ajouter un principal est mis en surbrillance.

  4. Vérifiez que vous souhaitez ajouter le principal autorisé.

    Capture d’écran de la fenêtre Vérifier le principal montrant une demande de confirmation d’ajout d’un principal autorisé.

Pour supprimer un principal autorisé existant, sélectionnez Supprimer le principal et confirmez l’action.

Capture d’écran de la fenêtre Supprimer le principal montrant une demande de confirmation de suppression d’un principal autorisé.

Contenu connexe