Utilisation de Kusto.Explorer

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Kusto.Explorer est une application de bureau qui vous permet d’explorer vos données à l’aide de l’Langage de requête Kusto dans une interface utilisateur facile à utiliser. Cet article vous montre comment utiliser des 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 sur une ou plusieurs tables.

1. Dans la liste déroulante Requête sous 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 Go.

   Une carte thermique de la grille table/emplacement horaire indique les termes qui s’affichent et où ils apparaissent.

   

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.

   

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 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 du 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 gris coloré. Appuyez sur F5 pour exécuter la requête.

Voici quelques exemples de requêtes supplémentaires :

// 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

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

Paramétrage de requête côté client

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. Pour plus de commodité, 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 entre {} crochets. Par exemple : {parameter1}.

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

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

Partager des requêtes et des résultats

Dans 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 offre un moyen pratique de partager des requêtes et des résultats de requête 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.

Création d’un lien profond

Le moyen le plus simple de créer un lien profond consiste à créer votre requête dans Kusto.Explorer, puis à l’utiliser Query and results 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’ils sont copiés dans un e-mail, un certain nombre de liens à exécuter s’affichent dans une petite police. Par exemple :

Le lien web ouvre la requête dans Azure Data Explorer. Le lien Bureau est le lien profond. Elle ouvre la requête dans Kusto.Explorer et définit le contexte de manière appropriée.

Si vous déplacez le lien vers un e-mail et appuyez sur Ctrl+K, vous pouvez voir l’URL réelle.

Liens profonds et requêtes paramétrables

Vous pouvez utiliser des requêtes paramétrables 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)

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 de la longueur du nom du cluster et 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.

Obtention de liens plus courts

Les requêtes peuvent devenir longues. Pour réduire la probabilité 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.

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

 UrlEncode(Base64Encode(GZip(original query)))

Arguments de ligne de commande Kusto.Explorer

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

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 façon 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 importe) :

[LocalScriptFile] [QueryString]

Arguments de ligne de commande

Arguments querystring

Exemple

Kusto.Explorer.exe c:\temp\script.kql "uri=https://help.kusto.windows.net/Samples;Fed=true&name=Samples"

Kusto.Explorer.exe c:\temp\script.kql "uri=https://<baseaddress>/groups/<GroupID>/databases/<DatabaseID>"

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

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.)

   

2. Sélectionnez Ajouter un principal pour ajouter un principal autorisé.

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

   

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

   

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

Contenu connexe

• Raccourcis clavier de Kusto.Explorer
• Options Kusto.Explorer
• Résolution des problèmes de Kusto.Explorer
• Caractéristiques du code Kusto.Explorer
• Langage de requête Kusto (KQL)