Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les filtres limitent les données présentées dans les visualisations de tableau de bord afin que les utilisateurs puissent se concentrer sur des données répondant à des critères spécifiques. Cette page explique les types de filtres disponibles et explique comment les utiliser.
Filtrer l’interactivité et l’étendue
Les auteurs de tableaux de bord peuvent configurer des filtres de manière interactive, ce qui permet aux visionneuses d’ajuster les valeurs de manière dynamique ou statique, où l’auteur du tableau de bord prédéfinit les valeurs de filtre. Les filtres interactifs permettent aux visionneuses de tableaux de bord de sélectionner les valeurs du jeu de données dans les visualisations associées. Un éditeur de tableau de bord configure les valeurs de filtre statique et les applique uniquement au widget dans lequel ils sont configurés, ce qui permet d’afficher des vues uniques du même jeu de données entre les widgets.
Les filtres de tableau de bord fonctionnent à différentes étendues, chacune présentant des caractéristiques spécifiques :
Filtres globaux : Filtres interactifs qui s’appliquent à toutes les pages d’un tableau de bord pour les visualisations qui partagent un ou plusieurs jeux de données. Les visionneuses peuvent ajuster ces valeurs de manière dynamique et les modifications affectent l’ensemble du tableau de bord. Consultez les filtres globaux.
Filtres au niveau de la page : Widgets de filtre interactifs qui s’appliquent à toutes les visualisations de la même page qui partagent un ou plusieurs jeux de données. Les visionneuses peuvent modifier ces valeurs pour modifier l’affichage de cette page spécifique.
Filtres au niveau du widget : Filtres statiques qui s’appliquent uniquement aux widgets de visualisation individuels où ils sont configurés. Les auteurs de tableaux de bord définissent des filtres avec des valeurs que les visionneuses ne peuvent pas modifier. Ces filtres créent des vues uniques du même jeu de données sur différents widgets.
Barre de filtre active
Tous les filtres actifs d’un tableau de bord sont affichés dans la barre de filtres active en haut du tableau de bord. Tout filtre (global ou au niveau de la page) n’est pas défini sur Tous, ainsi que tout filtrage croisé, apparaît dans cette barre. La barre de filtres actifs affiche tous les filtres globaux et au niveau de la page, ainsi que leurs valeurs, que la valeur soit définie par l’utilisateur ou héritée d’une valeur par défaut.
Filtrer le comportement de l’application
Par défaut, les filtres s’appliquent immédiatement lorsqu’une visionneuse sélectionne une valeur dans un menu déroulant. Les auteurs de tableaux de bord peuvent configurer des filtres à appliquer uniquement lorsque la visionneuse clique sur un bouton Appliquer , ce qui permet aux utilisateurs de sélectionner plusieurs valeurs de filtre avant de mettre à jour le tableau de bord. Pour configurer le comportement de l’application de filtre, consultez Configurer le comportement de l’application de filtre.
Filtres globaux
Pour afficher tous les filtres globaux, cliquez sur dans le coin supérieur gauche du tableau de bord. Un panneau s’ouvre sur le côté droit du tableau de bord.
Pour créer un filtre global :
- Cliquez sur
dans le coin supérieur gauche du canevas du tableau de bord.
- Cliquez sur +. Le panneau de configuration de filtre s’ouvre sur le côté droit du canevas.
- Configurez la configuration du filtre comme vous le feriez pour n’importe quel autre widget de filtre interactif. Pour obtenir des exemples de configuration de widgets de filtre, consultez les types de filtres de tableau de bord.
Remarque
Lorsque vous publiez un tableau de bord avec le panneau filtres globaux ouvert, le panneau reste ouvert pour les utilisateurs lorsqu’ils chargent le tableau de bord publié pour la première fois.
Widgets de filtre
Les widgets de filtre sont des éléments interactifs qui permettent aux utilisateurs d’ajuster les valeurs de filtre au niveau de la page sur les champs et paramètres du jeu de données.
Pour créer un widget de filtre :
- Cliquez sur
Ajoutez un filtre (champ/paramètre) pour ajouter un widget de filtre. Ensuite, placez le filtre sur une page dans le canevas du tableau de bord. Le filtre est sélectionné et un panneau de configuration s’ouvre sur le côté droit de l’écran.
- Activez le titre du widget pour afficher un champ de titre dans le widget. Modifiez le titre sur le widget.
- Activez la description.
- Dans le menu déroulant Filtre dans le panneau de configuration, sélectionnez sélecteur de plage de dates.
- Cliquez sur
située à côté de l’icône du signe plus dans le menu Champs. Cliquez sur tpep_pickup_datetime dans le menu déroulant.
Remarque
Les paramètres basés sur des requêtes combinent un filtre de champs et un filtre de paramètres dans un même widget. Pour plus d'informations, consultez les paramètres basés sur la requête .
Définir les valeurs de filtre par défaut
Les valeurs par défaut sont utilisées quand le tableau de bord est actualisé sans sélection d’une nouvelle valeur de filtre. Pour définir une valeur par défaut, sélectionnez une valeur dans la liste déroulante Valeur par défaut dans les paramètres de configuration du widget de filtre.
Les filtres s’appliquent à l’ensemble du jeu de données. Pour les petits jeux de données, les filtres sont appliqués dans le navigateur afin d’optimiser les performances. Si le jeu de données est plus grand, le filtre est ajouté à la requête qui est exécutée dans l’entrepôt SQL. Consultez Optimisation et mise en cache des jeux de données.
Filtrer les champs avec
Les filtres de champs réduisent la quantité de données via des champs spécifiques du jeu de données. Par exemple, un filtre de champs peut limiter les données à une plage de dates particulière en fonction d’un champ de date du jeu de données. Les filtres de champs peuvent être connectés à un ou plusieurs jeux de données, ce qui permet de modifier dynamiquement les valeurs de filtre disponibles en fonction des sélections. Pour connecter un filtre aux champs de plusieurs jeux de données, ajoutez plusieurs Champs, jusqu’à un par jeu de données. Le filtre s’applique à toutes les visualisations basées sur les jeux de données sélectionnés. La sélection d’une valeur pour un filtre modifie dynamiquement les valeurs disponibles affichées dans les menus déroulants pour les autres filtres. L’image suivante montre un panneau de configuration de filtre défini pour filtrer sur deux champs.
Filtrer sur des paramètres
Les filtres de paramètres modifient directement la requête SQL, permettant des ajustements dynamiques de la requête. Les filtres peuvent être connectés à un ou plusieurs paramètres. Pour connecter un filtre à plusieurs paramètres, ajoutez plusieurs paramètres dans le panneau de configuration du filtre. Un jeu de valeurs par défaut dans un widget de filtre remplace le jeu de valeurs par défaut dans l’éditeur de requête. Si un filtre est connecté à un paramètre, il exécute une requête sur l’entrepôt SQL, quelle que soit la taille du jeu de données. Consultez Travailler avec les paramètres du tableau de bord.
Vous pouvez définir des valeurs de paramètre acceptant un des types de données suivants :
- Chaîne
- de type nombre
- Integer
- Decimal
- Date
- Date et heure
- Plage de dates
- Plage de date et d’heure
Dois-je filtrer sur un champ ou un paramètre ?
Pour les jeux de données relativement petits, les filtres de champs effectuent souvent plus efficacement que les paramètres, car Azure Databricks les applique dans le navigateur sans réexécuter la requête.
Les paramètres remplacent les valeurs au moment de l’exécution et nécessitent toujours la réexécution de la requête associée. Toutefois, les paramètres peuvent offrir une plus grande flexibilité pour l’optimisation des requêtes. Les filtres de champs encapsulent votre SQL dans une expression de table commune (CTE) et s’appliquent à la fin d’une requête, ce qui peut être moins efficace dans certains cas.
Avec des paramètres, vous pouvez placer des conditions de filtre n’importe où dans la requête, par exemple avant une jointure plutôt qu’après celle-ci. Cette flexibilité vous permet d’optimiser les performances des requêtes en fonction de votre structure de données et des modèles d’accès. Par exemple, le filtrage avant une jointure réduit considérablement les données traitées pendant l’opération de jointure.
Le tableau suivant compare le filtrage directement sur les champs de jeu de données avec le filtrage à l’aide de paramètres.
| type de filtrage | Description | Performance | Polyvalence |
|---|---|---|---|
| Filtrage sur un champ | Appliqué directement aux champs du jeu de données sans modifier le jeu de données. | En règle générale, plus rapide. Les petits jeux de données peuvent être filtrés dans le navigateur. Les jeux de données volumineux sont filtrés en réexécutant la requête avec le prédicat de filtre appliqué. Consultez Optimisation et mise en cache des jeux de données. | Limité au filtrage des résultats de jeu de données résolus. Impossible d’utiliser les sous-requêtes ou dans une logique conditionnelle personnalisée. |
| Filtrage sur un paramètre | Remplace les valeurs directement dans la requête de jeu de données au moment de l’exécution. | Nécessite une réexécutation de la requête chaque fois que la valeur du paramètre change. | Peut être utilisé dans les sous-requêtes, la logique conditionnelle ou pour modifier la structure de requête. |
Types de filtres
Les filtres de champs et de paramètres prennent en charge différents types de filtres :
- Filtres de champs : valeur unique, valeurs multiples, sélecteur de dates, sélecteur de plage de dates, entrée texte, curseur de plage.
- Filtres de paramètres : Valeur unique, valeurs multiples, sélecteur de date, plage de dates.
Pour obtenir des exemples montrant comment configurer différents types de filtres, consultez types de filtres de tableau de bord.
Filtres dans les URL de tableau de bord publiées
Les tableaux de bord publiés stockent les filtres de champs et les sélections de paramètres dans l’URL. Cela permet aux utilisateurs d'ajouter aux favoris ou de partager un tableau de bord avec des configurations de filtre spécifiques. Lorsqu’un utilisateur ouvre l’URL, le tableau de bord se charge avec ces valeurs de filtre déjà appliquées.
Les identificateurs de filtre ne sont pas stockés en tant que valeurs nommées. Chaque filtre est identifié par une combinaison de la valeur de page name et de la valeur du widget name , séparées par un tilde (~). Ces valeurs sont générées automatiquement par défaut. L’identificateur et la valeur du filtre sont passés dans le cadre de l’URL pour charger le tableau de bord avec la sélection de filtre spécifiée.
Remarque
La name clé apparaît dans le fichier sérialisé qui définit le tableau de bord et n’est pas accessible à partir de l’interface utilisateur Azure Databricks. Elle est distincte de la "displayName" valeur, qui définit le nom de page affiché dans l’interface utilisateur. Consultez Modifier un fichier de tableau de bord.
L’exemple suivant montre la structure d’une URL de tableau de bord avec une valeur de filtre sélectionnée :
<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_<page-name>~<widget-name>=<filter-value>
- La première partie de l’URL identifie le tableau de bord publié. Consultez l’URL et l’ID du tableau de bord.
- La section qui identifie le filtre commence par
f_et est suivie dupage-nameet duwidget-name, séparés par un tilde (~). - La valeur à droite du signe égal (
=) est la valeur de filtre sélectionnée.
Les valeurs page-name et widget-name sont générées automatiquement lors de la création du tableau de bord. Vous pouvez modifier ces noms dans le fichier sérialisé lvdash.json . Les noms persistent entre les opérations telles que l’importation, l’exportation et la republication. Consultez Modifier un fichier de tableau de bord.
Accéder et définir des valeurs de filtre dans l’URL
L’exemple suivant montre une URL pour un tableau de bord publié qui inclut une valeur de filtre sélectionnée :
<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_53eadf26~3490f286=10013
Cet exemple fait référence à un tableau de bord avec trois filtres : Intervalle de temps, Code postal de prise en charge et Code postal de dépôt. Seul le filtre Code postal de prise en charge a une valeur assignée. Dans l’URL, il a été défini à 10013 à l'aide de l’identificateur f_53eadf26~3490f286.
Pour créer un tableau de bord similaire à celui utilisé dans cet exemple, consultez Créer un tableau de bord.
Spécifier des valeurs de plage de dates relatives dans l’URL
Si un filtre de temps relatif est utilisé, par exemple les 5 dernières minutes ou les dernières 12 heures, la valeur correspondante apparaît dans l’URL.
L’exemple suivant montre une URL avec les 12 dernières heures sélectionnées.
<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_53eadf26~3490f286=now-12h
Dans ce cas, l’identificateur de filtre f_53eadf26~3490f286 est défini sur la valeur relative now-12h.
Filtres de widget statiques
Les filtres statiques au niveau du widget affichent une vue du jeu de données défini par l’auteur du tableau de bord. Elles s’appliquent uniquement au widget dans lequel ils sont configurés, ce qui permet d’afficher des vues uniques du même jeu de données dans différents widgets. Contrairement aux filtres globaux et de niveau page, les filtres de widget statiques s’appliquent uniquement au widget de visualisation où ils sont configurés. Leurs valeurs de filtre ne peuvent pas être modifiées par les visionneuses du tableau de bord.
Exemple de cas d’usage
Supposons que vous créez un tableau de bord des ventes qui analyse les performances régionales. Vous utilisez un jeu de données avec des données de ventes pour toutes les régions. En appliquant des filtres de widget statiques, vous pouvez configurer un widget pour afficher les ventes pour la région A et un autre widget pour afficher les ventes pour la région B. Cette approche permet aux viewers de comparer les performances régionales côte à côte, même si les deux widgets produisent un graphique à partir du même jeu de données. Étant donné que les filtres de widget statiques sont fixes, les utilisateurs ne peuvent pas modifier les filtres, ce qui garantit que le tableau de bord présente toujours une vue cohérente des données.
Types de filtres pris en charge pour les filtres au niveau du widget
Les filtres au niveau du widget prennent en charge les types de filtres suivants :
- Valeur unique : Filtrer sur une valeur spécifique à partir d’un champ
- Plusieurs valeurs : Filtrer sur une ou plusieurs valeurs d’un champ
- Sélecteur de dates : Filtrer à une date spécifique
- Sélecteur de plages de dates : Filtrer sur une plage de dates, y compris les plages de dates relatives (par exemple, les 7 derniers jours, le mois dernier)
- Curseur de plage : Filtrer dans une plage numérique
- Entrée de texte : Filtrer en fonction de la correspondance de texte
Pour obtenir des exemples de configuration de chaque type de filtre, consultez les types de filtres de tableau de bord.
Ajouter un filtre au niveau du widget statique
Pour ajouter un filtre au niveau du widget statique à une visualisation :
Ajoutez un widget de visualisation au canevas du brouillon de tableau de bord.
Une fois le nouveau widget sélectionné, choisissez un jeu de données dans la liste déroulante Jeu de données du panneau de configuration.
Cliquez sur Afficher les filtres. Une option Filtrer les champs apparaît sous le titre du jeu de données. Pour les jeux de données qui incluent des paramètres, une section paramètres apparaît également.
Pour ajouter un filtre de champ, procédez comme suit :
- Cliquez sur le signe plus à droite du titre des champs de filtre et sélectionnez un champ dans le menu déroulant.
- Par défaut, la valeur du filtre est définie sur Tous. Utilisez le menu déroulant pour choisir une nouvelle valeur. Quittez le menu déroulant pour afficher la visualisation avec le nouveau filtre appliqué.
- Passez en revue votre tableau de bord.
Pour en savoir plus sur la définition d’un paramètre au niveau d’un widget statique, consultez Paramètres de widget statiques.