Démarrage rapide : Interroger des exemples de données dans 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 autonome Azure Data Explorer. Azure Data Explorer offre une expérience web qui se connecte à vos clusters Azure Data Explorer afin de pouvoir écrire, exécuter et partager des commandes et des requêtes Kusto Query Language (KQL). Vous pouvez accéder à l’expérience web dans le portail Azure ou en tant qu’application web autonome, l’interface utilisateur web Azure Data Explorer.

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

Dans ce guide de démarrage rapide, vous :

  • Ajoutez une connexion de cluster.
  • Exécutez des requêtes KQL sur des exemples de données.
  • Mettez en forme une requête et affichez un graphique.
  • Fournissez des commentaires et nettoyez les ressources.

Prérequis

Avant de commencer, vérifiez que vous disposez des éléments suivants :

Ajouter des clusters

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

Pour exécuter des requêtes sur un autre cluster, ajoutez 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 à l’aide des étapes précédentes et entrez help en tant qu’URI de connexion.

Exécuter une requête

Pour exécuter une requête, sélectionnez la base de données dans laquelle vous souhaitez exécuter la requête pour 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 Samples 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’un tableau répertoriant les données de 10 événements de tempête dans l’interface web d’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 la 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’un tableau qui répertorie l’heure de début, l’heure de fin, l’état, le type d’événement, la propriété de dommages et la narration d’épisode pour 10 événements storm 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 rappel vous permet de récupérer les résultats des requêtes précédentes.

  6. Exécutez une requête supplémentaire pour afficher 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 diagramme en colonnes résultant d’une requête.

    Remarque

    Les lignes vides dans l’expression de requête peuvent affecter quelle partie de la requête s’exécute.

    • Si vous ne sélectionnez aucun texte, la requête ou la commande est supposée être séparée par des lignes vides.
    • Si vous sélectionnez du texte, le texte sélectionné s’exécute.

Fournir des commentaires

Pour fournir des commentaires, procédez comme suit :

  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éé de ressources dans ce guide de démarrage rapide. Pour supprimer un ou les deux clusters de l’application, cliquez avec le bouton droit sur le cluster, puis sélectionnez Supprimer la connexion. Une autre option consiste à sélectionner Effacer l’état local sous l’onglet Paramètres>généraux . Cette action supprime toutes les connexions de cluster et ferme tous les onglets de requête ouverts.

Contenu connexe

  • Last updated on