Utiliser des paramètres dans des tableaux de bord Azure Data Explorer
Les paramètres sont utilisés comme blocs de construction pour les filtres dans les tableaux de bord Azure Data Explorer. Ils sont gérés dans le cadre des tableaux de bord et peuvent être ajoutés à des requêtes pour filtrer les données présentées par le visuel sous-jacent. Une requête peut utiliser un ou plusieurs paramètres.
Ce document décrit la création et l’utilisation de paramètres et de filtres liés dans des tableaux de bord. Les paramètres peuvent être utilisés pour filtrer les visuels du tableau de bord, directement en sélectionnant des valeurs de paramètres dans la barre de filtre ou en utilisant des filtres croisés.
Les exemples de requête utilisés dans cet article sont basés sur la StormEvents table de la galerie d’exemples.
Remarque
La gestion des paramètres est disponible en mode Édition pour les éditeurs de tableaux de bord.
Prérequis
- Visualiser des données avec des tableaux de bord Azure Data Explorer
- Autorisations de l’éditeur sur un tableau de bord Azure Data Explorer
- Tableau de bord avec des objets visuels
Consulter une liste de paramètres
Pour afficher la liste de tous les paramètres de tableau de bord, sélectionnez le bouton Paramètres en haut du tableau de bord.
Créer un paramètre
Pour créer un paramètre :
Passez de l’affichage au mode Édition .
Sélectionnez le bouton Paramètres en haut du tableau de bord.
Sélectionnez le bouton + Nouveau paramètre en haut du volet droit.
Renseignez les propriétés pertinentes pour votre paramètre.
Propriétés prises en charge
Dans le volet Ajouter un paramètre , configurez les propriétés suivantes :
| Champ | Description |
|---|---|
| Étiquette | Nom du paramètre affiché sur le tableau de bord ou la carte de modification. |
| Type de paramètre | L’un des paramètres suivants :
|
| Nom de la variable | Nom du paramètre à utiliser dans la requête. Conseil : le préfixe des noms de variables avec un caractère distinctif, tel qu’un caractère de soulignement (_), facilite leur recherche lors de l’écriture de requêtes. |
| Type de données | Type de données des valeurs de paramètre. |
| Afficher sur les lignes | Sélectionnez les pages où ce paramètre s’affichera. L’option Sélectionner tout affiche le paramètre sur toutes les pages. |
| Source | Source des valeurs de paramètre :
|
| Valeur par défaut | Valeur par défaut du filtre. Le filtre démarre toujours avec la valeur par défaut lors du rendu initial du tableau de bord. |
| Ajouter une valeur « Tout sélectionner » | S’applique uniquement aux types de paramètres Sélection unique et Sélection multiple. Permet de récupérer les données pour toutes les valeurs du paramètre. Cette valeur doit être intégrée à la requête pour fournir cette fonctionnalité. Pour plus d’exemples de création de ces requêtes, consultez Utiliser le paramètre basé sur plusieurs requêtes de sélection. |
Gérer les paramètres
Après avoir sélectionné Paramètres dans la barre supérieure, vous pouvez afficher la liste des paramètres existants. Dans chaque carte de paramètres, sélectionnez le widget de crayon pour modifier le paramètre ou sélectionnez le menu Plus [...] pour dupliquer, supprimer ou déplacer le paramètre.
Les indicateurs suivants sont affichés dans la carte de paramètres :
- Nom complet du paramètre
- Noms de variables
- Nombre de requêtes dans lesquelles le paramètre a été utilisé
- Pages auxquelles le paramètre est épinglé
Les cartes de paramètres peuvent être triées par glisser-déplacer ou à l’aide de l’option Déplacer vers > l’option et en sélectionnant le nouvel emplacement.
Utiliser des paramètres dans votre requête
Un paramètre doit être utilisé dans la requête pour rendre le filtre applicable pour le visuel de cette requête. Une fois les paramètres définis, vous pouvez les voir dans la page Requête> barre supérieure de filtre et dans la requête IntelliSense.
Remarque
Si le paramètre n’est pas utilisé dans la requête, le filtre reste inactif. Une fois le paramètre ajouté à la requête, le filtre devient actif.
Types de paramètres
Plusieurs types de paramètres de tableau de bord sont pris en charge, comme suit :
- Paramètre Intervalle de temps par défaut
- Paramètres à valeurs fixes et à sélection unique
- Paramètres à valeurs fixes et à sélection multiple
- Paramètres basés sur une requête et à sélection unique
- Paramètres basés sur une requête à sélection multiple
- Paramètres de texte libre
- Paramètres de source de données
Les exemples suivants décrivent comment utiliser des paramètres dans une requête pour différents types de paramètres.
Paramètre Intervalle de temps par défaut
Chaque tableau de bord dispose d’un paramètre Intervalle de temps par défaut. Il s’affiche dans le tableau de bord comme filtre uniquement quand il est utilisé dans une requête. Utilisez les mots clés de paramètre _startTime et _endTime pour utiliser le paramètre d’intervalle de temps par défaut dans une requête, comme indiqué dans l’exemple suivant :
StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents
Une fois enregistré, le filtre d’intervalle de temps s’affiche sur le tableau de bord. Il peut maintenant être utilisé pour filtrer les données sur la carte. Vous pouvez filtrer votre tableau de bord en sélectionnant dans la liste déroulante : Intervalle de temps (dernières x minutes/heures/jours) ou un Intervalle de temps personnalisé.
Paramètres à valeurs fixes et à sélection unique
Les paramètres à valeur fixe sont basés sur des valeurs prédéfinies spécifiées par l’utilisateur. L’exemple suivant vous montre comment créer un paramètre à valeur fixe et à sélection unique.
Créer un paramètre à valeurs fixes et à sélection unique
Sélectionnez Paramètres pour ouvrir le volet Paramètres, puis sélectionnez Nouveau paramètre.
Renseignez les détails comme suit :
Étiquette : Type d’événement
Type de paramètre : sélection unique
Nom de la variable :
_eventTypeType de données : Chaîne
Épingler comme filtre de tableau de bord : activé
Source : Valeurs fixes
Dans cet exemple, utilisez les valeurs suivantes :
Valeur Nom complet du paramètre Vent d’orage Vent d’orage Grêle Grêle Crue soudaine Crue soudaine Sécheresse Sécheresse Météo hivernale Météo hivernale Ajouter une valeur Tout sélectionner : décochée
Valeur par défaut : Vent orage
Sélectionnez Terminé pour créer le paramètre.
Le paramètre est affiché dans le volet latéral Paramètres, mais il n’est actuellement utilisé dans aucun visuel.
Utiliser un paramètre à valeurs fixes et à sélection unique
Exécutez un exemple de requête à l’aide du nouveau paramètre Event TypTope à l’aide du nom de la
_eventTypevariable :StormEvents | where StartTime between (_startTime.._endTime) | where EventType == _eventType | summarize TotalEvents = count() by State | top 5 by TotalEventsLe nouveau paramètre s’affiche dans la liste de paramètres en haut du tableau de bord.
Sélectionnez différentes valeurs pour mettre à jour les visuels.
Paramètres à valeurs fixes et à sélection multiple
Les paramètres à valeur fixe sont basés sur des valeurs prédéfinies spécifiées par l’utilisateur. L’exemple suivant vous montre comment créer et utiliser un paramètre à valeur fixe et à sélection multiple.
Créer des paramètres à valeurs fixes à sélection multiple
Sélectionnez Paramètres pour ouvrir le volet Paramètres, puis sélectionnez Nouveau paramètre.
Renseignez les détails comme indiqué dans Utiliser le paramètre à valeurs fixes et à sélection unique avec les changements suivants :
- Étiquette : Type d’événement
- Type de paramètre : sélection multiple
- Nom de la variable :
_eventType
Sélectionnez Terminé pour créer le paramètre.
Les nouveaux paramètres sont affichés dans le volet latéral Paramètres, mais ils ne sont actuellement utilisés dans aucun visuel.
Utiliser un paramètre à valeurs fixes et à sélection multiple
Exécutez un exemple de requête à l’aide du nouveau paramètre Event Type en utilisant la variable
_eventType.StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | summarize TotalEvents = count() by State | top 5 by TotalEventsLe nouveau paramètre s’affiche dans la liste de paramètres en haut du tableau de bord.
Sélectionnez une ou plusieurs valeurs différentes pour mettre à jour les visuels.
Paramètres basés sur une requête et à sélection unique
Les valeurs des paramètres basés sur une requête sont récupérées lors du chargement du tableau de bord en exécutant la requête avec paramètres. L’exemple suivant vous montre comment créer et utiliser un paramètre basé sur une requête et à sélection unique.
Créer un paramètre basé sur une requête et à sélection unique
Sélectionnez Paramètres pour ouvrir le volet Paramètres, puis sélectionnez Nouveau paramètre.
Renseignez les détails comme indiqué dans Utiliser le paramètre à valeurs fixes et à sélection unique avec les changements suivants :
Étiquette : état
Nom de la variable :
_stateSource : requête
Source de données : StormEventsSample
Sélectionnez Modifier la requête, puis entrez la requête suivante. Cliquez sur Terminé.
StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | summarize TotalEvents = count() by State | top 5 by TotalEvents | project StateValeur : état
Nom complet : State
Valeur par défaut : choisissez une valeur par défaut
Sélectionnez Terminé pour créer le paramètre.
Utiliser le paramètre basé sur une requête à sélection unique
L’exemple de requête suivant avec le nouveau paramètre State utilise la variable
_state:StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | where State == _state | summarize TotalEvents = count() by State | top 5 by TotalEventsLe nouveau paramètre s’affiche dans la liste de paramètres en haut du tableau de bord.
Sélectionnez différentes valeurs pour mettre à jour les visuels.
Paramètres basés sur une requête à sélection multiple
Les valeurs des paramètres basés sur une requête sont dérivées au moment du chargement du tableau de bord en exécutant la requête spécifiée par l’utilisateur. L’exemple suivant montre comment créer un paramètre basé sur une requête et à sélection multiple :
Créer un paramètre basé sur une requête et à sélection multiple
Sélectionnez Paramètres pour ouvrir le volet Paramètres, puis sélectionnez + Nouveau paramètre.
-
- Renseignez les détails comme indiqué dans Utiliser le paramètre à valeurs fixes et à sélection unique avec les changements suivants :
- Étiquette : état
- Type de paramètre : sélection multiple
- Nom de la variable :
_state
Sélectionnez Terminé pour créer le paramètre.
Utiliser un paramètre basé sur une requête et à sélection multiple
L’exemple de requête suivant utilise le nouveau paramètre State avec la variable
_state.StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | where State in (_state) or isempty(_state) | summarize TotalEvents = count() by State | top 5 by TotalEventsRemarque
Cet exemple utilise l’option Tout sélectionner en vérifiant la présence de valeurs vides avec la fonction
isempty().Le nouveau paramètre s’affiche dans la liste de paramètres en haut du tableau de bord.
Sélectionnez une ou plusieurs valeurs différentes pour mettre à jour les visuels.
Paramètres de texte libre
Les paramètres de texte libre ne contiennent aucune valeur. Ils vous permettent d’introduire votre propre valeur.
Créer un paramètre de texte libre
Sélectionnez Paramètres pour ouvrir le volet Paramètres, puis sélectionnez + Nouveau paramètre.
Renseignez les détails comme suit :
- Étiquette : état
- Type de paramètre : Texte libre
- Nom de variable : _state
- Type de données : Chaîne
- Valeur par défaut : Aucune valeur par défaut
Utiliser un paramètre de texte libre
Exécutez un exemple de requête à l’aide du nouveau paramètre State en utilisant le nom de variable
_state:StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | where State contains _state | summarize TotalEvents = count() by State | top 5 by TotalEvents
Paramètres de source de données
Une fois que vous avez ajouté des sources de données à votre tableau de bord, vous pouvez créer un paramètre qui sélectionne une ou plusieurs des sources de données disponibles. Ce paramètre peut être utilisé dans les vignettes et d'autres paramètres.
Créer un paramètre de source de données
Sélectionnez Paramètres pour ouvrir le volet Paramètres, puis sélectionnez + Nouveau paramètre.
Renseignez les détails comme suit :
- Étiquette : source
- Type de paramètre : source de données
- Afficher sur les pages : Sélectionner tout
- Valeurs : Sélectionner tout
- Valeur par défaut : StormEventsSample
Cliquez sur Terminé.
Le nouveau paramètre est désormais visible dans la liste de paramètres en haut du tableau de bord.
Utiliser un paramètre de source de données
Naviguez vers la requête d’une vignette nouvelle ou existante.
Dans Source, sélectionnez le nom de votre nouveau paramètre sous paramètres de source de données. Pour le paramètre créé ci-dessus, sélectionnez Cluster.
Sélectionnez Appliquer les modifications.
Utilisez le paramètre cluster pour modifier la source de données de cette requête connectée.
Paramètres de filtres croisés
Les filtres croisés vous permettent de sélectionner une valeur dans un visuel et tous les visuels du tableau de bord, comme les graphiques en courbes ou à nuages de points, sont filtrés pour afficher seulement les données associées. L’utilisation de filtres croisés permet d’obtenir le même résultat que la sélection de la valeur équivalente pour le paramètre dans la liste de paramètres en haut du tableau de bord.
Définir des filtres croisés
Pour créer un filtre croisé, vous devez activer l’option dans le visuel et spécifier le paramètre utilisé pour filtrer les données.
Accédez à la requête de la vignette dans laquelle vous souhaitez ajouter des filtres croisés.
Sélectionner Visuel.
Dans le volet droit, sélectionnez Interactions, puis activez les filtres croisés.
Si vous le souhaitez, spécifiez le type d’Interaction. La valeur par défaut est Point, où vous pouvez sélectionner une valeur dans le visuel. Pour sélectionner une plage de valeurs, comme dans un graphique chronologique, sélectionnez Glisser.
Spécifiez à la fois la colonne utilisée pour fournir la valeur et un paramètre utilisé pour filtrer la requête.
Important
La colonne et le paramètre doivent être du même type de données.
Interagir avec vos données en utilisant un filtre croisé
Une fois le filtre croisé défini, vous pouvez l’utiliser pour interagir avec vos données. Dans les visuels dans lesquels vous avez défini des filtres croisés, vous pouvez sélectionner des points de données et utiliser leurs valeurs pour filtrer les pages du tableau de bord actif. Pour les visuels de table, sélectionnez les points de données en cliquant avec le bouton droit sur la cellule appropriée puis, dans le menu contextuel, sélectionnez Filtre croisé.
Vous pouvez réinitialiser le filtre croisé en sélectionnant Réinitialiser en haut du visuel où il a été sélectionné.
Utiliser des extractions comme paramètres de tableau de bord
Avec l’extraction, vous pouvez sélectionner une valeur dans un visuel et l’utiliser pour filtrer les visuels d’une page cible dans le même tableau de bord. Lorsque la page cible s’ouvre, la valeur est présélectionnée dans les filtres appropriés. Les visuels de la page, tels que les graphiques en courbes ou à nuages de points, sont filtrés pour afficher uniquement les données associées.
Définir une extraction
Pour créer une extraction, vous devez d’abord l’activer dans le visuel, puis ajouter une ou plusieurs extractions si nécessaire.
Modifiez le visuel dans lequel vous souhaitez ajouter une extraction. Vérifiez que l’onglet Visuel est sélectionné.
Dans le volet droit, sélectionnez Interactions, puis activez l’extraction.
Sous Extraction, sélectionnez Créer et spécifiez les informations suivantes. Sélectionnez éventuellement Ajouter une autre paire pour ajouter plusieurs paramètres pour une page cible. Répétez cette étape pour ajouter des extractions à d’autres pages du tableau de bord actuel à l’aide de différents paramètres.
Champ Description Page de destination Une ou plusieurs pages cibles à explorer pour utiliser les paramètres définis. Colonne Colonne du résultat de la requête à utiliser comme valeur pour un paramètre dans la page cible. Paramètre Paramètre utilisé pour filtrer les visuels dans la page cible à l’aide de la valeur de colonne. Notes Brève description facultative. Important
Les paires colonne/paramètre doivent être du même type de données.
Interagir avec vos données à l’aide d’extractions
Une fois que les extractions ont été définies, vous pouvez les utiliser pour interagir avec vos données. Pour ce faire, dans les visuels ou les tables où vous avez défini une extraction, cliquez avec le bouton droit sur un point de données, puis sélectionnez Extraction dans>la page de destination. Les valeurs du point de données seront utilisées comme paramètres pour filtrer les visuels sur la page cible.
Pour revenir à la page source, en haut à droite de la page de destination, sélectionnez Réinitialiser. Tous les filtres attribués par l’extraction seront réinitialisés.
Utiliser la recherche de filtre pour les filtres mono- et multi-sélection
Dans les filtres mono- ou multi-sélection, tapez la valeur de votre choix. Le filtre est mis à jour pour afficher uniquement les valeurs qui correspondent au critère de recherche.