Création d’une requête de base pour le tableau de bord

Les requêtes de base sont des extraits de requête réutilisables qui peuvent être utilisés en tant que blocs de construction pour tous les composants de requête de tableau de bord, tels que les paramètres, les vignettes et d’autres requêtes de base. Une requête de base unique est gérée dans le contexte d’un tableau de bord spécifique. Chaque tableau de bord peut avoir une ou plusieurs requêtes de base. Les requêtes de base facilitent la maintenance des requêtes dans les tableaux de bord, car les requêtes peuvent être gérées dans un emplacement central.

Pour explorer de manière interactive des exemples de tableaux de bord, consultez Démarrage rapide : Visualiser des exemples de tableaux de bord de données.

Remarque

La création et la gestion des requêtes de base sont disponibles en mode Édition pour les éditeurs de tableau de bord.

Important

Lorsque vous utilisez des requêtes de base, vous ne pouvez pas faire référence à une autre source de données que celle déjà utilisée dans une vignette ou un paramètre particulier.

Prérequis

  • Un compte Microsoft ou une identité utilisateur Microsoft Entra. Un abonnement Azure n’est pas requis.
  • Autorisations de modification de tableau de bord sur un tableau de bord Azure Data Explorer

Créer une requête de base

  1. Basculez le mode tableau de bord de l’affichage vers la modification.

    Capture d’écran de la page d’accueil du tableau de bord.

  2. En haut du tableau de bord, sélectionnez Requêtes de base.

    Capture d’écran du menu du tableau de bord dans Azure Data Explorer avec l’option requêtes de base mise en surbrillance par une zone rouge.

    Le volet de requête de base s’ouvre à droite.

  3. Sélectionnez + Ajouter.

    Capture d’écran de la nouvelle requête de base dans les tableaux de bord Azure Data Explorer.

  4. Entrez un nom de variable à utiliser comme référence à cette requête de base.

    Remarque

    Nous vous suggérons de commencer chaque nom de requête de base avec un trait de soulignement (_) pour faciliter l’utilisation ultérieure, afin de ne pas entrer en conflit avec les noms définis par Kusto. Pour plus d’informations, consultez nommage de vos entités

    Capture d’écran de la création d’une requête de base dans les tableaux de bord Azure Data Explorer.

  5. Sélectionnez une source de données dans la liste déroulante.

  6. Entrez la requête KQL qui sera utilisée comme requête de base. Cette requête peut éventuellement contenir d’autres requêtes de base.

  7. Cliquez sur Terminé.

Gérer les requêtes de base

Dans le volet de requête de base, vous pouvez afficher la liste des requêtes de base existantes. Dans chaque carte de requête de base, sélectionnez le widget crayon pour modifier la requête de base, ou sélectionnez le menu Plus [...] pour dupliquer, supprimer ou déplacer la requête de base. L’ordre de requête de base peut également être modifié en faisant glisser et en supprimant la carte.

Les indicateurs suivants peuvent être consultés dans la carte de requêtes de base :

  • Nom de la variable de requête de base
  • Nombre de vignettes dans lesquelles la requête de base a été utilisée
  • Nombre de paramètres dans lesquels la requête de base a été utilisée
  • Nombre de requêtes de base dans lesquelles la requête de base a été utilisée

Utiliser une requête de base

Les requêtes de base peuvent être utilisées dans les vignettes de tableau de bord, les paramètres et d’autres requêtes de base. Utilisez la requête de base en entrant ['variablename'] dans l’éditeur de requête.

Capture d’écran de l’utilisation d’une requête de base dans les tableaux de bord Azure Data Explorer.