Partager un tableau de bord
Cet article explique comment publier un tableau de bord et le partager avec les utilisateurs de votre Workspace ou de votre compte.
Que sont les autorisations de partage de données ?
Les autorisations de données partagées vous permettent de partager votre tableau de bord avec n'importe qui dans votre compte Databricks, qu'ils aient ou non un accès explicite aux données et au compute sous-jacents nécessaires pour remplir et mettre à jour le tableau de bord.
Lorsque vous publiez un tableau de bord, vous devez choisir l’un des paramètres suivants :
- Partager les autorisations de données (default) : Les utilisateurs exécutent des requêtes à l'aide des autorisations de données de l'éditeur. Cela permet aux utilisateurs d'afficher le tableau de bord même s'ils n'ont pas un accès direct aux données sous-jacentes. Cela pourrait exposer des données à des utilisateurs qui n'y ont pas un accès direct.
- Autorisation des données individuelles :
- Les spectateurs exécutent des queries en utilisant leurs propres identifiants. Leurs autorisations de données déterminent les résultats qu'ils peuvent voir, et ils doivent avoir accès aux données sous-jacentes. L'adhésion au workspace n'est pas requise. Les utilisateurs du compte disposant des autorisations de données appropriées peuvent consulter le tableau de bord.
- L’accès au compute est toujours accordé par les identifiants de l’éditeur.
Pour partager efficacement les insights d'un tableau de bord, les utilisateurs doivent pouvoir accéder à la fois aux données sous-jacentes et aux ressources de compute utilisées pour exécuter les queries associées. Si vous choisissez de ne pas partager avec vos autorisations de données, vous devez vérifier que les utilisateurs disposent des autorisations nécessaires pour accéder aux données affichées sur le tableau de bord. Utilisez les autorisations de partage de données lorsque vous partagez des tableaux de bord avec des utilisateurs qui n'ont pas accès aux données sous-jacentes ou au compute.
Pour les tableaux de bord brouillons, les autorisations de données de l'utilisateur sont toujours appliquées, même si le tableau de bord est publié avec des autorisations de données partagées.
Le tableau suivant résume l'accès et les limitations accordés par chaque option de publication.
Option de publication | Qui exécute les requêtes | Accès aux données déterminé par | Qui peut consulter | Idéal pour |
|---|---|---|---|---|
Partager les autorisations de données (default) | Éditeur | Autorisations de l'éditeur | Utilisateurs et groupes ayant un accès explicitement accordé. Les utilisateurs doivent être enregistrés auprès du compte, mais ne nécessitent pas l'accès au Workspace. | Expérience cohérente pour les utilisateurs sans accès au Workspace |
Autorisations de données individuelles | Chaque utilisateur | Autorisations propres au spectateur | Utilisateurs ayant explicitement reçu un accès au tableau de bord et disposant d'autorisations de données sur les données sous-jacentes. L'adhésion au Workspace n'est pas requise. | Utilisateurs disposant d'autorisations de données directes, y compris les utilisateurs de compte qui ne nécessitent pas d'adhésion au Workspace |
Qui peut accéder à votre tableau de bord ?
Vous pouvez partager des tableaux de bord avec des utilisateurs et des groupes dans votre compte Databricks ou votre Workspace. Les utilisateurs de Workspace disposant du droit Databricks SQL peuvent se voir attribuer différents niveaux d'autorisations qui contrôlent la façon dont ils interagissent avec vos tableaux de bord. Les utilisateurs disposant du droit d'accès **Consommateur** et les utilisateurs du compte sont limités à un accès en lecture seule à votre tableau de bord. Ils peuvent afficher et exécuter le tableau de bord, mais ils ne peuvent pas le modifier, ni les datasets sous-jacents qui le prennent en charge. Ce niveau d'accès correspond aux rôles en lecture seule dans d'autres systèmes de visualisation de données, avec l'avantage supplémentaire de ne pas nécessiter de licence spéciale.
Accès utilisateur au Workspace
Les membres du Workspace se voient accorder des droits qui contrôlent la manière dont ils interagissent avec le Workspace Databricks.
Les utilisateurs disposant du droit Databricks SQL peuvent se voir accorder l'autorisation d'accéder aux tableaux de bord brouillons et publiés.
- Peut accéder aux versions brouillon et publiée d'un tableau de bord. Ils doivent disposer au moins de l'autorisation CAN EDIT pour modifier et republier un brouillon. Pour afficher tous les niveaux d’autorisation et les capacités associées, consultez Dashboard ACLs.
Les utilisateurs disposant du droit d'accès **Consommateur** sont limités à un accès en lecture et exécution seule. Ils peuvent exécuter le tableau de bord, appliquer des filtres, interagir avec les visualisations et partager l'URL du tableau de bord avec les autres utilisateurs du Workspace. Ils ne peuvent pas créer ou modifier un tableau de bord ou modifier ses paramètres de partage. Pour en savoir plus sur le droit d'**accès du consommateur**,consultez Gérer les droits.
Les tableaux de bord héritent des autorisations Workspace définies sur le dossier parent. Par default, les tableaux de bord sont stockés dans le répertoire /Workspace/Users/<username>. Toute personne ayant accès au dossier parent peut également accéder à votre tableau de bord. Seuls les administrateurs du Workspace peuvent modifier la propriété d'un tableau de bord. Consultez le guide d'administration AI/BI.
Accès utilisateur du compte
Les membres enregistrés de votre compte Databricks sans accès au Workspace peuvent se voir accorder l'accès à une copie en lecture seule d'un tableau de bord. Ils utilisent les informations d'identification de l'éditeur pour accéder aux Ressources de compute et devraient se voir attribuer les autorisations appropriées pour accéder aux données sous-jacentes. Les membres n'ayant pas accès au workspace ne peuvent pas accéder à la version brouillon du tableau de bord et ne voient pas les éléments de navigation du workspace Databricks dans la barre latérale gauche ou près du haut de l'écran. L'image suivante montre la vue d'un utilisateur de compte alors qu'il navigue vers différents tableaux de bord partagés.
Pour que les membres de votre compte puissent accéder aux tableaux de bord partagés, un administrateur doit d'abord les enregistrer avec votre compte Databricks. Le partage au niveau du compte de tableau de bord prend en charge l'e-mail et l'authentification par code d'accès unique, ainsi que la connexion unifiée avec l'authentification unique (SSO). Cette étape restreint l’accès au tableau de bord partagé aux seuls membres désignés du compte, plutôt que de permettre à toute personne disposant du Link de le consulter. Consultez le guide d’administration AI/BI.
Les utilisateurs de compte qui ne sont pas membres d'un Workspace ne peuvent pas accéder aux données du tableau de bord à partir d'éléments sécurisables liés au Workspace, tels que les catalogues liés au Workspace, même s'ils ont les autorisations sur les tables ou les catalogues sous-jacents. Les objets liés au Workspace nécessitent un accès au Workspace par conception. Les widgets de tableau de bord qui interrogent les éléments sécurisables liés au Workspace n'affichent pas de données pour les utilisateurs du compte.
Pour en savoir plus sur la comparaison entre l'accès des utilisateurs de compte et l'**accès consommateur**, voir l'accès consommateur et les utilisateurs de compte.
Publier un tableau de bord
Avant de pouvoir partager un tableau de bord, vous devez le publier. La publication crée un instantané de votre tableau de bord auquel les spectateurs peuvent accéder. La version publiée reste inchangée jusqu’à ce que vous republiiez, même si vous continuez à modifier le brouillon.
Pour publier un tableau de bord :
-
Ouvrir l’ébauche du tableau de bord.
-
Cliquez sur **Publier** dans le coin supérieur droit du tableau de bord.
-
Choisissez l'une des options d'autorisations de données suivantes :
- Partager les autorisations de données (default) : les spectateurs exécutent des requêtes à l'aide des autorisations de données de l'éditeur. Utilisez cette option pour partager avec les utilisateurs qui n'ont pas accès aux données sous-jacentes. Le champ Identifiant de l'éditeur affiche l'identifiant sélectionné, qui default à votre compte d'utilisateur. Pour publier en utilisant plutôt les identifiants d'un Service Principal, cliquez sur le menu kebab à côté de cette option et sélectionnez un Service Principal.
- Autorisations de données individuelles : Les spectateurs exécutent des requêtes à l’aide de leurs propres identifiants. Utilisez cette option lorsque les spectateurs doivent voir les données en fonction de leurs propres autorisations.
-
Cliquez sur Publier .
Après la publication, la boîte de dialogue Partage s'ouvre automatiquement, vous permettant de partager immédiatement le tableau de bord publié.
Partager un tableau de bord publié
Les tableaux de bord publiés peuvent être partagés avec les éléments suivants :
- Utilisateurs et groupes spécifiques dans votre Workspace
- Utilisateurs et groupes spécifiques dans votre compte Databricks
- Tous les utilisateurs de votre compte Databricks
Si vous souhaitez partager avec tout le monde dans votre compte Databricks, utilisez le paramètre de partage : Consultable par toute personne inscrite sur mon compte . Si vous souhaitez partager avec tout le monde dans votre Workspace, utilisez le groupe système : Tous les utilisateurs du Workspace .
Suivez les étapes suivantes pour partager votre tableau de bord :
-
Ouvrez un tableau de bord brouillon ou publié.
-
Cliquez sur Partager , puis utilisez la boîte de dialogue Partage pour définir les autorisations pour les utilisateurs et les groupes de votre compte.
- En haut de la boîte de dialogue, saisissez les utilisateurs et les groupes avec lesquels vous souhaitez partager. Vous pouvez attribuer des niveaux d'autorisation spécifiques, tels que CAN EDIT et CAN MANAGE. Ensuite, cliquez sur Ajouter .
- Pour attribuer rapidement un accès en consultation à toute personne de votre compte Databricks, utilisez l'option **Paramètres de partage** en bas de la boîte de dialogue **Partage**.
Les utilisateurs ont besoin d'un accès au Workspace pour gérer ou modifier un tableau de bord. Les administrateurs du Workspace peuvent ajouter des utilisateurs au Workspace. Consultez Gérer les utilisateurs.
Les utilisateurs n'ayant pas accès au workspace sont limités aux autorisations CAN RUN. Si vous accordez des autorisations élevées, telles que CAN EDIT, à un utilisateur qui n'a pas accès au workspace, ces autorisations apparaissent dans la boîte de dialogue Partage , mais ses autorisations réelles sont limitées à CAN RUN. Les autorisations élevées ne peuvent être appliquées que si l'utilisateur est ajouté au workspace. Si un niveau d'autorisation plus élevé est attribué à l'utilisateur et qu'il est ensuite ajouté au workspace, il peut interagir avec les tableaux de bord selon l'autorisation attribuée. Consultez Listes de contrôle d'accès aux tableaux de bord pour plus d'informations sur les niveaux d'autorisation des tableaux de bord.
-
Partager le Link avec les utilisateurs.
- Cliquez sur Copier Link en bas de la boîte de dialogue Partage pour copier une URL partageable pour le tableau de bord publié.
- En option, vous pouvez intégrer votre tableau de bord dans un autre site web ou une autre application.
Utilisez un Service Principal pour publier et partager des tableaux de bord
Utilisez l'API REST pour publier et partager des tableaux de bord avec des autorisations de données partagées associées à un Service Principal. Lorsque les utilisateurs exécutent des appels d'API avec le jeton du Service Principal, ils accèdent aux données sous les autorisations du Service Principal. Cette configuration permet aux utilisateurs qui ne disposent pas d'autorisations directes en matière de données ou de compute de consulter le tableau de bord et d'exécuter des queries, pour autant qu'ils soient enregistrés auprès de votre compte Databricks.
Pour publier un tableau de bord avec les identifiants Service Principal, vous vous authentifiez d'abord en tant que Service Principal pour obtenir un jeton d'accès OAuth, puis vous utilisez ce jeton pour appeler l'Endpoint API de publication du tableau de bord avec embed_credentials défini sur true. Le tableau de bord est publié avec les informations d'identification du Service Principal intégrées, ce qui permet aux utilisateurs d'accéder au tableau de bord sans avoir besoin d'autorisations directes sur les données ou les ressources de compute sous-jacentes.
Pour des instructions étape par étape et des exemples d'API, consultez Publier un tableau de bord avec les informations d'identification du Service Principal. Pour plus de détails sur l'utilisation de l'API REST pour gérer les tableaux de bord, consultez Lakeview dans la référence de l'API REST.
download un tableau de bord publié
Une fois qu'un tableau de bord publié est chargé, suivez les étapes suivantes pour le download au format PDF :
- Cliquez sur l'
près du coin supérieur droit du tableau de bord. - Cliquez sur **download au format PDF**.
Gérer les autorisations du tableau de bord
Vous pouvez partager en toute sécurité des tableaux de bord avec n'importe qui dans votre compte. Pour les utilisateurs attribués à votre Workspace, vous pouvez accorder l'accès et définir différents niveaux d'autorisation comme vous le feriez pour d'autres objets du Workspace. Pour les utilisateurs qui ne sont pas affectés à votre Workspace, vous pouvez partager des tableaux de bord au niveau du compte, permettant aux utilisateurs enregistrés de visualiser et d'exécuter votre tableau de bord.
Pour plus de détails sur la manière dont les administrateurs peuvent configurer votre compte pour le partage au niveau du compte, consultez le guide d'administration AI/BI.
Pour des information sur les niveaux d'autorisation sur les tableaux de bord, consultez les ACL de tableau de bord.
Transférer la propriété du tableau de bord
Seuls les administrateurs de Workspace peuvent transférer la propriété d’un tableau de bord. Pour changer le propriétaire d'un tableau de bord, un administrateur de Workspace peut utiliser la boîte de dialogue des permissions du tableau de bord ou l'API REST Lakeview. Voir Transfert de propriété d'un tableau de bord.
La propriété du tableau de bord n'accorde pas de privilèges spéciaux. Le propriétaire a le même accès que tout utilisateur disposant de l'autorisation CAN MANAGE sur le tableau de bord.