Utiliser des paramètres basés sur une requête

L’article vous guide tout au long des étapes de création d’un tableau de bord interactif qui utilise des paramètres basés sur une requête. Il suppose une connaissance de base de la création de tableaux de bord sur Azure Databricks. Consultez Bien démarrer pour obtenir des instructions de base sur la création de tableaux de bord.

Spécifications

• Vous êtes connecté à un espace de travail Azure Databricks.
• Vous disposez du droit SQL dans cet espace de travail.
• Vous avez au moins l’autorisation PEUT UTILISER sur un ou plusieurs entrepôts SQL.

Créer un jeu de données de tableau de bord

Ce tutoriel utilise des données générées à partir du catalogue d’exemples d’Azure Databricks.

1. Dans la barre latérale, cliquez sur Nouveau, puis sélectionnez Tableau de bord dans le menu.

2. Cliquez sur l'onglet Données .

3. Cliquez sur Créer à partir de SQL, puis collez la requête suivante dans l’éditeur. Cliquez ensuite sur Exécuter pour retourner les résultats.

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. Votre jeu de données nouvellement défini est enregistré automatiquement sous le nom Jeu de données sans titre. Double-cliquez sur le titre, puis renommez-le Segment marketing.

Ajouter un paramètre

Vous pouvez ajouter un paramètre à ce jeu de données pour filtrer les valeurs retournées. Dans cet exemple, le paramètre est :segment. Pour en savoir plus sur la syntaxe des paramètres, consultez Utiliser les paramètres de tableau de bord.

1. Collez la clause WHERE suivante au bas de votre requête. Un champ de texte avec le nom de paramètre segment apparaît sous votre requête.

   WHERE
     c_mktsegment = :segment
   

2. Tapez BUILDING dans le champ de texte situé sous votre requête pour définir la valeur par défaut du paramètre.

3. Réexécutez la requête pour inspecter les résultats.

Configurer un widget de visualisation

Ajoutez une visualisation pour votre jeu de données sur le canevas en suivant les étapes ci-dessous :

1. Cliquez sur l’onglet Canevas.
2. Cliquez sur Ajouter une visualisation pour ajouter un widget de visualisation, puis utilisez votre souris pour la placer sur le canevas.

Configurer l’axe X

1. Si nécessaire, sélectionnez Barre dans le menu déroulant Visualisation.
2. Cliquez sur pour choisir les données présentées le long de l’axe X. Vous pouvez utiliser la barre de recherche pour rechercher un champ par nom. Sélectionnez c_nationkey.
3. Cliquez sur le nom du champ sélectionné pour afficher des options de configuration supplémentaire.
   • Pour Type d’échelle, sélectionnez Par catégorie.
   • Pour la sélection Transformer, choisissez Aucun.

Configurer l’axe Y

1. Cliquez sur en regard de l’axe Y, puis sélectionnez c_acctbal.
2. Cliquez sur le nom du champ sélectionné pour afficher des options de configuration supplémentaire.
   • Pour le Type de mise à l’échelle, sélectionnez Quantitative.
   • Pour la sélection Transformer, choisissez SOMME.

La visualisation est automatiquement mise à jour au fur et à mesure que vous la configurez. Les données affichées incluent uniquement les enregistrements où segment est BUILDING.

Ajouter un filtre

Configurez un filtre pour permettre aux viewers qui consultent les tableaux de bord de contrôler le segment marketing à cibler.

1. Cliquez sur Ajouter un filtre (champ/paramètre) pour ajouter un widget de filtre. Placez-le sur le canevas.
2. Dans le menu déroulant Filtre du panneau de configuration, sélectionnez Valeur unique.
3. Cochez la case Titre pour afficher un champ de titre dans votre widget de filtre.
4. Cliquez sur l’espace réservé correspondant au titre du widget, puis tapez Segment pour donner un nouveau titre à votre filtre.
5. Cliquez sur à côté de Paramètres dans le panneau de configuration.
6. Choisissez segment dans le jeu de données Segment marketing.

Votre widget de filtre configuré affiche la valeur de paramètre par défaut du jeu de données.

Définir une sélection de valeurs

Le filtre que vous avez créé est fonctionnel. Toutefois, le viewer doit connaître l’éventail des choix disponibles pour pouvoir effectuer une sélection. Il oblige également les utilisateurs à respecter la casse et l’orthographe quand ils entrent la valeur de paramètre souhaitée.

Pour créer une liste déroulante afin que le viewer puisse sélectionner un paramètre dans une liste d’options disponibles, créez un jeu de données définissant la liste des valeurs possibles.

1. Cliquez sur l'onglet Données .

2. Cliquez sur Créer à partir de SQL pour créer un jeu de données.

3. Copiez ce qui suit, puis collez-le dans l’éditeur :

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. Exécutez votre requête, puis inspectez les résultats. Les cinq segments marketing de la table apparaissent dans les résultats.

5. Double-cliquez sur le titre généré automatiquement, puis renommez ce jeu de données Choix du segment.

Mettre à jour le filtre

Mettez à jour votre filtre existant pour utiliser le jeu de données que vous venez de créer afin de remplir une liste déroulante de valeurs pouvant être choisies par les utilisateurs.

1. Cliquez sur Canevas. Cliquez ensuite sur le widget de filtre que vous avez créé à une étape précédente.
2. Cliquez sur en regard de Champs.
3. Cliquez sur Choix du segment, puis cliquez sur le nom de champ c_mktsegment.

Votre widget de filtre est mis à jour quand vous changez la configuration. Cliquez sur le champ dans le widget de filtre pour voir les choix disponibles dans le menu déroulant.

Étapes suivantes

Continuez à découvrir l’utilisation des tableaux de bord en lisant les articles suivants :

• Découvrez plus en détail comment appliquer des filtres. Consultez Utiliser des filtres.
• Découvrez plus en détail les paramètres de tableau de bord. Consultez Utiliser les paramètres de tableau de bord.
• Publiez et partagez votre tableau de bord. Consultez Publier un tableau de bord.