Tableaux de bord hérités

Vous pouvez utiliser l’éditeur SQL pour créer un tableau de bord hérité qui combine des visualisations et des zones de texte qui fournissent du contexte avec vos données.

Afficher et organiser des tableaux de bord hérités

Vous pouvez accéder aux tableaux de bord à partir du navigateur de l’espace de travail ainsi qu’à d’autres objets Azure Databricks.

• Cliquez sur Espace de travail dans la barre latérale pour afficher les tableaux de bord à partir du navigateur de l’espace de travail. Par défaut, les tableaux de bord sont stockés dans le répertoire /Workspace/Users/<username>. Les utilisateurs peuvent organiser les tableaux de bord en dossiers dans l’explorateur d’espace de travail avec d’autres objets Azure Databricks.

• Pour afficher la page répertoriant les tableaux de bord, cliquez sur Tableaux de bord dans la barre latérale.

• Cliquez sur l’onglet Tableaux de bord hérités pour afficher les tableaux de bord hérités.

  Par défaut, l’onglet Mes tableaux de bord est sélectionné et affiche les tableaux de bord que vous possédez, triés dans l’ordre chronologique inverse. Pour réorganiser la liste, cliquez sur l’en-tête Créé à. Vous pouvez également utiliser les onglets en haut de la page pour afficher les favoris ou tous les tableaux de bord. Utilisez l’onglet Balises pour filtrer par balise.

Organiser les tableaux de bord en dossiers dans l’explorateur d’espace de travail

Organisez les tableaux de bord nouveaux et existants en dossiers dans l’explorateur d’espace de travail avec d’autres objets Azure Databricks. Consultez Navigateur d’espace de travail.

Filtrer la liste des tableaux de bord enregistrés

Filtrer la liste de tous les tableaux de bord par tableaux de bord que vous avez créés (Mes tableaux de bord), sur vos favoris et sur des étiquettes.

Créer un tableau de bord hérité

Vous ne pouvez plus créer de nouveaux tableaux de bord hérités. Databricks recommande plutôt d’utiliser des tableaux de bord IA/BI. Pour en savoir plus, consultez Tableaux de bord. Pour obtenir des instructions sur la création d’un tableau de bord, consultez Créer un tableau de bord.

Cloner un tableau de bord hérité

Le clonage des tableaux de bord hérités n’est plus pris en charge. Pour convertir un tableau de bord hérité existant en tableau de bord IA/BI, consultez Cloner un tableau de bord hérité en tableau de bord IA/BI.

Utilisation de paramètres de requête dans des tableaux de bord hérités

Les requêtes peuvent éventuellement tirer parti de paramètres ou de valeurs statiques. Lorsqu’une visualisation basée sur une requête paramétrable est ajoutée à un tableau de bord, la visualisation peut être configurée pour utiliser les éléments suivants :

• Paramètre de widget : les paramètres de widget sont spécifiques à une visualisation unique dans un tableau de bord. Ils apparaissent dans le panneau de visualisation, et les valeurs de paramètre spécifiées s’appliquent uniquement à la requête sous-jacente à la visualisation.
• Paramètre de tableau de bord : les paramètres des tableaux de bord hérités peuvent s’appliquer à plusieurs visualisations. Lorsque vous ajoutez une visualisation basée sur une requête paramétrable à un tableau de bord, le paramètre est compté par défaut comme paramètre de tableau de bord. Les paramètres de tableau de bord sont configurés pour une ou plusieurs visualisations dans un tableau de bord et apparaissent en haut du tableau de bord. Les valeurs de paramètre spécifiées pour un paramètre de tableau de bord s’appliquent aux visualisations réutilisant ce paramètre de tableau de bord particulier. Un tableau de bord peut avoir plusieurs paramètres, chacun pouvant s’appliquer à certaines visualisations et non à d’autres.
• Valeur statique : des valeurs statiques sont utilisées à la place d’un paramètre qui répond à des modifications. Les valeurs statiques vous permettent de coder en dur une valeur à la place d’un paramètre et font que le paramètre « disparaît » du tableau de bord ou du widget où il apparaissait précédemment.

Lorsque vous ajoutez une visualisation contenant une requête paramétrable, vous pouvez choisir le titre et la source du paramètre dans la requête de visualisation en cliquant sur l’icône de crayon appropriée. Vous pouvez également sélectionner le mot clé et une valeur par défaut. Voir Propriétés de paramètre.

Après avoir ajouté une visualisation à un tableau de bord, vous pouvez accéder à l’interface de mappage de paramètres en cliquant sur en haut à droite d’un widget de tableau de bord, puis en cliquant sur Modifier les paramètres du widget.

Propriétés du paramètre

Les propriétés du paramètre du widget de tableau de bord sont les suivantes :

• Titre : nom d’affichage qui apparaît à côté du sélecteur de valeurs sur le tableau de bord. Par défaut, le titre est défini dans l’éditeur de requête. Pour modifier son affichage dans le tableau de bord, cliquez sur l’icône en ’orme de crayon . Les titres ne sont pas affichés pour les paramètres statiques du tableau de bord, car le sélecteur de valeur est masqué. Si vous sélectionnez Valeur statique comme source de valeur, le champ Titre est grisé.

• Mot clé : littéral de chaîne de ce paramètre dans la requête sous-jacente. Cette information est utile pour le débogage si le tableau de bord ne renvoie pas les résultats attendus.

• Valeur par défaut : valeur définie pour ce paramètre au chargement du tableau de bord jusqu’à ce qu’un autre soit sélectionné et que des modifications soient appliquées. Pour modifier cette valeur par défaut, ouvrez la requête sous-jacente dans l’éditeur SQL, remplacez le paramètre par la valeur souhaitée, puis cliquez sur le bouton Enregistrer.

• Source de la valeur : source de la valeur du paramètre. Cliquez sur l’icône en ’orme de crayon pour choisir une source.

  • Nouveau paramètre de tableau de bord : créez un paramètre au niveau du tableau de bord. Cela vous permet de définir une valeur de paramètre à un seul endroit sur votre tableau de bord et de l’associer à une ou plusieurs visualisations. Les paramètres doivent avoir un nom unique dans le tableau de bord.
  • Paramètre de tableau de bord existant : mappez le paramètre de cette visualisation à un paramètre de tableau de bord existant. Vous devez spécifier le paramètre de tableau de bord préexistant.
  • Paramètre de widget : affiche un sélecteur de valeur dans le widget de votre tableau de bord. Ceci est utile pour les paramètres uniques qui ne sont pas partagés entre les widgets.
  • Valeur statique : choisissez une valeur statique pour le widget, quelles que soient les valeurs utilisées sur les autres widgets. Les valeurs de paramètres statiques n’affichent pas de sélecteur de valeur sur le tableau de bord, ce qui est plus compact. Cela vous permet de profiter de la flexibilité des paramètres de requête sans encombrer l’interface utilisateur sur un tableau de bord lorsque certains paramètres ne sont pas censés changer fréquemment.

  

Modifier un tableau de bord hérité

Pour ouvrir le tableau de bord pour modification, ouvrez Menu kebab en haut à droite du tableau de bord et sélectionnez Modifier.

Lors de la modification, vous pouvez ajouter et supprimer du contenu, modifier des visualisations et appliquer des filtres. Pour modifier l’ordre dans lequel les paramètres sont affichés, vous pouvez cliquer sur chaque paramètre et le faire glisser jusqu’à la position de votre choix.

Filtrer plusieurs requêtes

Pour filtrer plusieurs requêtes sur un tableau de bord :

1. Accédez à votre tableau de bord hérité.
2. En mode Édition, cliquez sur Ajouter, puis sur Filtrer.
3. Sélectionnez Nouveau filtre de tableau de bord et choisissez les requêtes et les colonnes à filtrer. Vous pouvez également choisir d’importer des filtres à partir de requêtes existantes en sélectionnant Filtres de requête existants et en choisissant d’importer un filtre à partir d’un éditeur de requête SQL. Les requêtes que vous choisissez doivent appartenir au même catalogue et au même schéma.
4. Cliquez sur Enregistrer. Cela crée un filtre qui contient l’union de toutes les options de liste déroulante.

Modifier la visualisation de tableau de bord

Pour modifier une visualisation dans le tableau de bord en mode Édition, sélectionnez la visualisation que vous souhaitez modifier, puis cliquez sur en haut à droite de la visualisation. Dans la liste affichée, sélectionnez Modifier la visualisation.

Ajouter du contenu à un tableau de bord

1. Ouvrez le tableau de bord pour modification.
2. Cliquez sur Add Textbox (Ajouter une zone de texte) ou sur Add Widget (Ajouter un widget).
3. Cliquez sur Ajouter au tableau de bord hérité.
4. Cliquez sur Fin de l’édition.

Vous pouvez également ajouter une visualisation à un tableau de bord dans l’éditeur SQL.

Supprimer le contenu d’un tableau de bord

1. Cliquez sur SQL ou pointez sur l’objet, cliquez sur Menu kebab en haut à droite du widget, puis sélectionnez Supprimer du tableau de bord.
2. Cliquez sur Supprimer.

Filtres du tableau de bord

Lorsque les requêtes ont des filtres, vous devez également appliquer les filtres au niveau du tableau de bord. Cochez la case Use Dashboard Level Filters (Utiliser les filtres au niveau du tableau de bord) pour appliquer le filtre à toutes les requêtes.

Personnaliser les couleurs du tableau de bord

Vous pouvez personnaliser la palette de couleurs du tableau de bord, y compris la création d’une palette de couleurs.

Créer une palette de couleurs

Pour créer une palette de couleurs personnalisée pour un tableau de bord :

1. Cliquez sur en haut à droite, puis cliquez sur Modifier.
2. Cliquez sur Couleurs.
3. Pour importer une palette de couleurs existante, cliquez sur Importer, puis sélectionnez la palette. Vous pouvez personnaliser la palette importée.
4. Pour créer une palette ou personnaliser une palette importée, procédez comme suit :
   1. Pour ajouter une couleur, cliquez sur Ajouter.
   2. Pour une couleur qui vient d’être ajoutée ou une couleur existante, spécifiez-la en procédant de l’une des façons suivantes :
      • Cliquer sur le carré, puis sélectionner la nouvelle couleur en cliquant dessus dans le sélecteur de couleurs ou en utilisant la pipette.
      • Cliquez sur le champ de texte en regard du carré et entrez une valeur hexadécimale.
5. Cliquez sur Appliquer.

Arrêter d’utiliser une palette de couleurs personnalisée

Pour supprimer une palette de couleurs personnalisée :

1. Cliquez sur en haut à droite, puis cliquez sur Modifier.
2. Cliquez sur Couleurs.
3. Cliquez sur Effacer.
4. Cliquez sur Appliquer.

Utiliser une palette de couleurs différente pour une visualisation

Par défaut, si une palette de couleurs a été appliquée dans un tableau de bord, toutes les visualisations utilisent cette palette. Si vous souhaitez utiliser différentes couleurs pour une visualisation, vous pouvez remplacer ce comportement :

1. Cliquez sur pour la visualisation dans le tableau de bord, puis cliquez sur Modifier.
2. Cochez la case Conserver les couleurs spécifiées sur la visualisation.
3. Cliquez sur OK.

Actualiser un tableau de bord

Les tableaux de bord hérités sont conçus pour un chargement efficace, car ils récupèrent des données à partir d’un cache qui se renouvelle chaque fois qu’une requête s’exécute. Toutefois, vos tableaux de bord peuvent devenir obsolètes si vous n’exécutez pas régulièrement les requêtes associées. Pour empêcher vos tableaux de bord de devenir obsolètes, vous pouvez les actualiser pour réexécuter les requêtes associées.

Chaque fois qu’un tableau de bord est actualisé, manuellement ou en suivant un calendrier spécifique, toutes les requêtes qui y sont référencées sont actualisées. Lorsqu’une visualisation individuelle est actualisée, la requête en amont est actualisée. L’actualisation manuelle du tableau de bord ou de la visualisation individuelle n’actualise pas les requêtes utilisées dans les listes déroulantes basées sur des requêtes. Pour plus d’informations, consultez Liste déroulante basée sur une requête.

Comportement d’actualisation et contexte d’exécution

Lorsqu’un tableau de bord est « Exécuter en tant que propriétaire » et qu’une planification est ajoutée, les informations d’identification du propriétaire sont utilisées pour l’exécution, et toute personne disposant d’au moins l’autorisation CAN RUN voit les résultats de ces requêtes actualisées.

Lorsqu’un tableau de bord est « Exécuter en tant que visionneuse » et qu’une planification est ajoutée, les informations d’identification du propriétaire sont utilisées pour l’exécution, mais seul le propriétaire voit les résultats des requêtes actualisées ; tous les autres utilisateurs doivent effectuer une actualisation manuelle pour afficher les résultats de requête mis à jour.

Actualiser manuellement un tableau de bord

Pour forcer une actualisation, cliquez sur Actualiser en haut à droite du tableau de bord. Cela entraîne l’exécution de toutes les requêtes du tableau de bord et la mise à jour de ses visualisations.

Actualiser automatiquement un tableau de bord

Le propriétaire et les utilisateurs d’un tableau de bord disposant de l’autorisation CAN EDIT peuvent configurer un tableau de bord pour qu’il s’actualise automatiquement selon une planification. Pour actualiser automatiquement un tableau de bord :

1. Cliquez sur Planifier dans le coin supérieur droit du tableau de bord. Cliquez ensuite sur Ajouter une planification.

2. Utilisez les sélecteurs de liste déroulante pour spécifier la fréquence, la période, l’heure de début et le fuseau horaire. Si vous le souhaitez, cochez la case Afficher la syntaxe cron pour modifier la planification dans la syntaxe Quartz Cron.

3. Choisissez Autres options pour afficher les paramètres facultatifs. Vous pouvez choisir :

   • Un nom pour la planification.
   • Un entrepôt SQL pour exécuter la requête. Par défaut, l’entrepôt SQL utilisé pour une exécution de requête ad hoc est également utilisé pour un travail planifié. Utilisez ce paramètre facultatif pour sélectionner un autre entrepôt afin d’exécuter la requête planifiée.

   Note

   Cet entrepôt peut être différent de celui utilisé pour l’actualisation manuelle.

4. Facultatif : dans l’onglet Abonnés, entrez la liste des adresses e-mail à notifier lorsque le tableau de bord est mis à jour automatiquement. Chaque adresse e-mail doit être associée à un compte Azure Databricks avec accès à l’espace de travail ou défini comme destination de notification dans les paramètres de l’espace de travail. Les destinations de notification sont configurées par un administrateur de l’espace de travail.

5. Cliquez sur Créer. Le libellé Planifier est remplacé par Planification(1).

6. Modifiez les paramètres de partage.

   Note

   Les autorisations du tableau de bord ne sont pas liées aux autorisations de planification. Après avoir créé votre intervalle d’actualisation planifié, modifiez les autorisations de planification pour fournir l’accès à d’autres utilisateurs. Seuls les utilisateurs disposant de l’autorisation PEUT GÉRER peuvent modifier la planification ou la liste des abonnés.

   • Cliquez sur le menu à trois points .
   • Cliquez sur Modifier les autorisations de planification.
   • Choisissez un utilisateur ou un groupe à partir du menu déroulant de la boîte de dialogue.
   • Choisissez PEUT AfficheR pour permettre aux utilisateurs sélectionnés d’afficher la configuration de la planification.

L’autorisation PEUT AfficheR ou PEUT EXÉCUTER permet au destinataire assigné de voir la présence d’une planification, ainsi que d’autres propriétés telles que la cadence de rapport et le nombre d’abonnés. L’autorisation PEUT GÉRER permet au destinataire de modifier la planification, la liste des abonnés et l’autorisation de planification. L’autorisation PEUT GÉRER permet également au destinataire de suspendre ou de supprimer la planification.

Comportement d’actualisation sur un tableau de bord ouvert

Lorsque vous ouvrez un tableau de bord défini sur Run as Owner, il affiche les données de la dernière mise à jour du tableau de bord, qu’elle ait été planifiée ou effectuée manuellement. Si un tableau de bord est ouvert dans une fenêtre de navigateur et qu’une requête est modifiée ou qu’une exécution planifiée met à jour les résultats du tableau de bord, les modifications ne sont pas immédiatement reflétées. Les résultats mis à jour s’afficheront la prochaine fois que vous ouvrirez le tableau de bord ou que vous actualiserez la fenêtre de navigateur ouverte.

Abonnements aux instantanés de tableau de bord

Vous pouvez périodiquement exporter et envoyer par e-mail des instantanés de tableau de bord. Les instantanés de tableau de bord sont extraits de l’état par défaut du tableau de bord, ce qui signifie que l’instantané est exempt de toute interaction avec les filtres et visualisations.

Si vous disposez au moins d’une autorisation CAN EDIT, vous pouvez créer une planification d’actualisation et abonner d’autres utilisateurs, qui recevront des instantanés par e-mail du tableau de bord chaque fois qu’il est actualisé. Pour ajouter des abonnés, entrez les utilisateurs ou les groupes requis dans l’onglet Abonnés comme décrit ci-dessus. Les abonnés éligibles incluent les utilisateurs de l’espace de travail et les destinations de notification.

Il existe une limite de taille de fichier de 6 Mo pour les pièces jointes de courrier électronique. Si un e-mail d’abonnement au tableau de bord dépasse la limite de taille de 6 Mo, l’e-mail omet l’instantané du tableau de bord inline et n’inclut qu’un FICHIER PDF de l’instantané du tableau de bord.

Si le fichier d’instantané PDF dépasse 6 Mo, l’e-mail de l’abonnement omet le FICHIER PDF et inclut plutôt un lien vers le tableau de bord actualisé. L’e-mail inclura un avertissement détaillant la taille actuelle du tableau de bord. (Les utilisateurs peuvent tester la taille de l’instantané PDF en téléchargeant manuellement un fichier PDF du tableau de bord.)

Suspendre temporairement les mises à jour planifiées du tableau de bord

Si un tableau de bord est configuré pour les mises à jour automatiques et que vous avez au moins l’autorisation PEUT AfficheR au niveau de la planification, le libellé du bouton Planification indique Planification(#), où # correspond au nombre d’événements planifiés que vous pouvez voir. En outre, si vous avez au moins l’autorisation PEUT GÉRER au niveau de la planification, vous pouvez suspendre temporairement la planification. Cela est utile pour éviter d’envoyer des mises à jour pendant le test des modifications apportées au tableau de bord. Pour suspendre temporairement les mises à jour planifiées du tableau de bord sans modifier la liste des abonnés :

1. Cliquez sur Planification(#).
2. Cliquez sur le menu à trois points .
3. Cliquez sur Suspendre.

Arrêter la mise à jour automatique d’un tableau de bord

Pour arrêter la mise à jour automatique du tableau de bord et supprimer ses abonnements :

1. Cliquez sur Planification(#).
2. Cliquez sur >Supprimer.

Limites de taille du tableau de bord pour les abonnements

Les e-mails d’abonnement au tableau de bord hérité incluent les fichiers encodés en base64 suivants :

• PDF : fichier PDF qui inclut le tableau de bord complet.
• DesktopImage : fichier image optimisé pour l’affichage sur les ordinateurs de bureau.

Une taille limite maximale de 6 Mo est imposée aux deux fichiers combinés. Les descriptions suivantes illustrent le comportement attendu lorsque la taille des fichiers combinés dépasse cette limite :

• Si le fichier PDF est supérieur à 6 Mo : l’e-mail d’abonnement n’inclut pas le PDF en pièce jointe ni les images. Il inclut une note indiquant que le tableau de bord a dépassé la limite de taille et affiche la taille de fichier réelle du tableau de bord actuel.
• Si la taille des fichiers combinés est supérieure à 6 Mo : seul le fichier PDF est joint à l’e-mail. Le message intégré inclura un lien vers le tableau de bord, mais aucune image.

Télécharger au format PDF

Pour télécharger un tableau de bord en tant que fichier PDF, cliquez sur Menu kebab en haut à droite du tableau de bord et sélectionnez Télécharger au format PDF.

Déplacer un tableau de bord hérité vers la Corbeille

Pour déplacer un tableau de bord vers la Corbeille, procédez comme suit :

1. Cliquez sur le menu à trois points en haut à droite du tableau de bord, puis sélectionnez Déplacer vers la corbeille.
2. Confirmez en cliquant sur Move to Trash (Déplacer vers la Corbeille).

Restaurer un tableau de bord hérité depuis la Corbeille

1. Cliquez sur Espace de travail dans la barre latérale.
2. Cliquez sur Corbeille dans le navigateur de l’espace de travail pour afficher les ressources qu’elle contient.
3. Cliquez sur le menu à trois points en regard du tableau de bord que vous souhaitez restaurer.
4. Cliquez sur Restaurer. Une boîte de dialogue Déplacer s’affiche.
5. Utilisez la boîte de dialogue Déplacer pour choisir un nouvel emplacement pour le tableau de bord restauré.

Supprimer définitivement un tableau de bord hérité

1. Cliquez sur Espace de travail dans la barre latérale.
2. Cliquez sur Corbeille dans le navigateur de l’espace de travail pour afficher les ressources qu’elle contient.
3. Cliquez sur à côté du tableau de bord que vous souhaitez supprimer.
4. Cliquez sur Supprimer définitivement.
5. Confirmez en cliquant sur Supprimer.

Ouvrir une requête

Pour ouvrir la requête affichée dans un widget dans l’éditeur SQL, cliquez sur Menu kebab en haut à droite du widget et sélectionnez Afficher la requête.

Configurer les autorisations d’un tableau de bord hérité et la propriété du tableau de bord

Vous devez disposer de l’autorisation PEUT GÉRER au niveau d’un tableau de bord pour pouvoir configurer des autorisations. Pour les niveaux d’autorisation du tableau de bord, consultez Listes de contrôle d’accès des tableaux de bord hérités.

1. Dans la barre latérale, cliquez sur Tableaux de bord.
2. Cliquez sur un tableau de bord.
3. Cliquez sur le bouton en haut à droite pour ouvrir la boîte de dialogue Partage.
4. Recherchez et sélectionnez les groupes ou les utilisateurs, puis attribuez-leur le niveau d’autorisation souhaité.
   1. définissez les informations d’identification sur Exécuter en tant que lecteur pour attribuer les autorisations PEUT ModifIER ou PEUT GÉRER.
5. Cliquez sur Add.

Pour partager rapidement toutes les requêtes associées à votre tableau de bord, cliquez sur l’icône d’engrenage et sélectionnez Partager toutes les requêtes. Les requêtes référencées par le tableau de bord ont des autorisations distinctes et ne sont pas partagées par défaut lorsque vous partagez le tableau de bord.

Transférer la propriété d’un tableau de bord hérité

Si le propriétaire d’un tableau de bord est supprimé d’un espace de travail, le tableau de bord n’a plus de propriétaire. L’utilisateur administrateur d’un espace de travail peut transférer la propriété de n’importe quel tableau de bord, y compris sans propriétaire, à un autre utilisateur. La propriété d’un tableau de bord ne peut pas être attribuée à des groupes. Vous pouvez également transférer la propriété à l’aide de l’API Autorisations.

1. En tant qu’administrateur d’espace de travail, connectez-vous à votre espace de travail Azure Databricks.

2. Dans la barre latérale, cliquez sur Tableaux de bord.

3. Cliquez sur un tableau de bord.

4. Cliquez sur le bouton Partager en haut à droite pour ouvrir la boîte de dialogue Partage.

5. Cliquez sur l’icône d’engrenage en haut à droite, puis cliquez sur Affecter un nouveau propriétaire.

   

6. Sélectionnez l’utilisateur auquel attribuer la propriété.

7. Cliquez sur Confirmer.

Accéder à la vue d’administration

Un utilisateur administrateur d’espace de travail Azure Databricks dispose d’un accès en lecture à tous les tableaux de bord de cet espace de travail. Dans cette vue, tout administrateur de l’espace de travail peut afficher et supprimer n’importe quel tableau de bord. Toutefois, un administrateur d’espace de travail ne peut pas modifier un tableau de bord lorsque le partage des informations d’identification est défini sur Exécuter en tant que propriétaire.

Pour afficher tous les tableaux de bord hérités :

1. Dans la barre latérale, cliquez sur Tableaux de bord.
2. Cliquez sur l’onglet Tableaux de bord hérités.
3. Cliquez sur l’onglet Tous les tableaux de bord en haut de l’écran.