Démarrage rapide : Interroger des exemples de données

  • Article

Azure Data Explorer fournit une expérience web qui vous permet de vous connecter à vos clusters Azure Data Explorer et d’écrire, d’exécuter et de partager des commandes et des requêtes Langage de requête Kusto (KQL). L’expérience web est disponible dans le portail Azure et en tant qu’application web autonome, l’interface utilisateur web Azure Data Explorer. Dans ce guide de démarrage rapide, vous allez apprendre à interroger des données dans l’interface utilisateur web azure Data Explorer autonome.

Dans l’interface utilisateur web Azure Data Explorer, l’éditeur de requête fournit des suggestions et des avertissements lors de l’écriture de vos requêtes. Pour personnaliser les suggestions et avertissements que vous recevez, consultez Définir des recommandations de requête.

Prérequis

Ajouter des clusters

Lorsque vous ouvrez l’interface utilisateur web pour la première fois, dans la page Requête , vous devez voir une connexion au cluster d’aide . Les exemples de ce guide de démarrage rapide utilisent la StormEvents table dans la Samples base de données du cluster d’aide .

Si vous souhaitez exécuter des requêtes sur un autre cluster, vous devez ajouter une connexion à ce cluster.

Pour ajouter une nouvelle connexion de cluster, procédez comme suit :

  1. Dans le menu de gauche, sélectionnez Requête.
  2. Dans le volet supérieur gauche, sélectionnez Ajouter une connexion.
  3. Dans la boîte de dialogue Ajouter une connexion , entrez l’URI de connexion du cluster et le nom d’affichage.
  4. Sélectionnez Ajouter pour ajouter la connexion.

Si vous ne voyez pas le cluster d’aide , ajoutez-le en suivant les étapes précédentes. Utilisez « help » comme URI de connexion.

Exécuter des requêtes

Pour exécuter une requête, vous devez sélectionner la base de données sur laquelle vous souhaitez exécuter la requête afin de définir le contexte de requête.

  1. Dans le volet Connexion du cluster, sous le cluster help, sélectionnez la base de données Samples.

    Capture d’écran de la base de données Exemples sélectionnée.

  2. Copiez et collez la requête ci-après dans la fenêtre de requête. En haut de la fenêtre, sélectionnez Exécuter.

    Exécuter la requête

    StormEvents
| sort by StartTime desc
| take 10

    Cette requête retourne les 10 enregistrements les plus récents dans la table StormEvents. Le résultat doit ressembler à la table suivante.

    Capture d’écran d’une table qui liste les données de 10 événements orageux dans l’interface utilisateur web Azure Data Explorer.

  3. Copiez et collez la requête ci-après dans la fenêtre de requête, sous la première requête. Notez qu’elle ne se présente pas sur des lignes distinctes comme la première requête.

    Exécuter la requête

    StormEvents | sort by StartTime desc 
| project StartTime, EndTime, State, EventType, DamageProperty, EpisodeNarrative | take 10

  4. Sélectionnez la nouvelle requête. Appuyez sur Maj+Alt+F pour mettre en forme la requête afin qu’elle ressemble à la requête suivante.

    Capture d’écran d’une requête avec la mise en forme correcte.

  5. Sélectionnez Exécuter ou appuyez sur Maj + Entrée pour exécuter une requête. Cette requête retourne les mêmes enregistrements que la première, mais contient uniquement les colonnes spécifiées dans l’instruction project. Le résultat doit ressembler à la table suivante.

    Capture d’écran d’une table qui liste l’heure de début, l’heure de fin, l’état, le type d’événement, les dommages et la description des épisodes pour 10 événements orageux dans l’interface utilisateur web Azure Data Explorer.

    Conseil

    Sélectionnez Rappeler en haut de la fenêtre de la requête pour afficher le jeu de résultats de la première requête sans devoir réexécuter la requête. Souvent, lors de l’analyse, vous exécutez plusieurs requêtes et l’option Rappel vous permet de récupérer les résultats des requêtes précédentes.

  6. Exécutons une autre requête pour voir un autre type de sortie.

    Exécuter la requête

    StormEvents
| summarize event_count=count(), mid = avg(BeginLat) by State
| sort by mid
| where event_count > 1800
| project State, event_count
| render columnchart

    Le résultat doit ressembler au graphique suivant.

    Capture d’écran d’un histogramme comme sortie d’une requête.

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

Fournir des commentaires

  1. En haut à droite de l’application, sélectionnez l’icône de commentaires .

  2. Entrez vos commentaires et sélectionnez Envoyer.

Nettoyer les ressources

Vous n’avez pas créé aucune ressource dans ce guide de démarrage rapide, mais si vous souhaitez supprimer un ou les deux clusters de l’application, cliquez avec le bouton droit sur le cluster et sélectionnez Supprimer la connexion. Une autre option consiste à sélectionner l’option Effacer l’état local de l’onglet Paramètres>Général. Cette action supprime toutes les connexions de cluster et ferme tous les onglets de requête ouverts.

Contenu connexe