Looker stocke les Looks (résultats de requêtes visualisés enregistrés) et les tableaux de bord (collections de vignettes affichant les résultats de requêtes visualisés) dans des dossiers. L'accès à ces dossiers est contrôlé par des niveaux d'accès et des autorisations utilisateur.
Niveaux d'accès aux dossiers
Un utilisateur ou un groupe d'utilisateurs peut disposer de l'un des deux niveaux d'accès suivants pour un dossier :
Afficher : l'utilisateur ou le groupe peut voir le dossier, afficher les Looks et les tableaux de bord qu'il contient, et copier les Looks et les tableaux de bord du dossier.
Gérer l'accès, Modifier : l'utilisateur ou le groupe dispose d'un accès Afficher et peut également gérer l'accès au dossier, ainsi que modifier le dossier et son contenu (y compris renommer des dossiers, déplacer du contenu et supprimer des Looks et des tableaux de bord).
Pour en savoir plus sur l'accès au contenu et les autorisations, consultez Contrôler l'accès au contenu utilisateur et Interaction entre l'accès au contenu et les autorisations.
Afficher et gérer les niveaux d'accès aux dossiers
Pour gérer un dossier, vous devez disposer des autorisations appropriées de votre administrateur Looker et du niveau d'accès Gérer l'accès, Modifier pour ce dossier. Vous pouvez ainsi modifier le nom d'un dossier, créer des sous-dossiers et spécifier les utilisateurs qui peuvent afficher ou gérer le dossier.
Accédez au dossier :
Cliquez sur l'icône en forme de roue dentée Toggle Dropdown .
Sélectionnez Gérer l'accès.
Si vous n'êtes pas autorisé à modifier les niveaux d'accès, vous ne pouvez pas gérer le dossier. Les niveaux d'autorisation ne seront pas sélectionnables et vous ne pourrez pas ajouter de groupe ni d'utilisateur.
Si un champ de texte contenant le texte d'espace réservé Ajouter un groupe ou un utilisateur s'affiche après les autres groupes et utilisateurs, vous pouvez gérer le dossier.
Si le dossier est un sous-dossier, Looker indique s'il hérite des paramètres de niveau d'accès de son parent.
Si vous souhaitez personnaliser les paramètres de niveau d'accès pour un ensemble spécifique d'utilisateurs et de groupes, vous pouvez les ajouter à une liste et les gérer individuellement.
Pour modifier le niveau d'accès d'un utilisateur ou d'un groupe, sélectionnez le niveau d'accès actuel, puis choisissez celui que vous souhaitez utiliser. Vous ne pouvez pas modifier la possibilité des administrateurs Looker de gérer le dossier.
Pour supprimer le niveau d'accès d'un groupe ou d'un utilisateur, sélectionnez le X à côté du nom.
Pour ajouter un ou plusieurs groupes ou utilisateurs, sélectionnez le champ Ajouter un groupe ou un utilisateur, choisissez un groupe ou un utilisateur, puis sélectionnez le niveau d'accès choisi. Sélectionnez Ajouter pour sélectionner un niveau d'accès pour le groupe ou l'utilisateur.
Créer un dossier
Vous pouvez créer un dossier dans le dossier Partagé ou dans votre dossier personnel. Par défaut, un dossier hérite des niveaux d'accès de son parent.
Cliquez sur le bouton Nouveau.
Sélectionnez l'option Dossier.
Dans la fenêtre Créer un dossier, saisissez un nom pour le dossier.
Sélectionnez Créer un dossier.
Définir votre dossier par défaut
Par défaut, si votre administrateur a activé l'option de page d'accueil Looker prédéfinie, Looker affiche Dossiers partagés dans le volet de navigation de gauche. Si vous définissez un autre dossier par défaut, il remplace Dossiers partagés dans le volet de navigation de gauche.
Pour définir un autre dossier comme dossier par défaut :
Accédez au dossier que vous souhaitez définir comme dossier par défaut.
Cliquez sur l'icône en forme de roue dentée Toggle Dropdown .
Sélectionnez Définir comme dossier par défaut.
Le dossier par défaut s'affiche dans la section Dossiers du volet de navigation principal.
Renommer, déplacer ou supprimer un dossier
Vous pouvez renommer, déplacer ou supprimer des sous-dossiers dans Partagé ou dans votre dossier personnel. Toutefois, vous ne pouvez pas modifier les dossiers de premier niveau, tels que Partagé ou votre dossier personnel de premier niveau, de cette manière.
Accédez au dossier :
Cliquez sur l'icône en forme de roue dentée Toggle Dropdown .
Sélectionnez Renommer, Déplacer ou Supprimer.
Copier ou déplacer des Looks et des tableaux de bord
Si vous disposez du niveau d'accès Gérer l'accès, Modifier pour un dossier, vous pouvez copier ou déplacer ses Looks et ses tableaux de bord définis par l'utilisateur vers un autre dossier. Vous pouvez également déplacer un tableau de bord LookML vers un autre dossier si vous disposez de l'autorisation develop sur le modèle qui inclut le tableau de bord LookML.
Si un tableau de bord comporte des vignettes basées sur des Looks, ces Looks doivent se trouver dans le même dossier que le tableau de bord. Si vous essayez de déplacer un Look utilisé dans un tableau de bord, Looker en crée une copie dans le nouvel emplacement et le conserve dans son emplacement d'origine. Cela permet de s'assurer qu'aucune vignette ne manque dans votre tableau de bord. Si vous copiez ou déplacez un tableau de bord vers un nouvel emplacement, Looker copie ou déplace également ses Looks vers le nouvel emplacement.
Cochez la case de tous les éléments que vous souhaitez modifier. Si la page d'accueil Looker prédéfinie est activée et que vous êtes en mode Grille, vous pouvez placer le pointeur sur une vignette pour afficher la coche, puis la sélectionner pour inclure le Look ou le tableau de bord.
Une fois une case cochée, sélectionnez Copier ou Déplacer.
Dans la fenêtre Copier ou Déplacer, sélectionnez le nom d'un dossier de premier niveau à gauche pour y accéder.
Sélectionnez un sous-dossier dans la liste ou accédez à un sous-dossier subordonné. Vous pouvez également saisir le nom du sous-dossier dans le champ Filtrer par titre pour filtrer la liste.
Sélectionnez OK.
Éviter les erreurs Duplicate Dashboard avec les tableaux de bord LookML
Les tableaux de bord LookML sont identifiés de manière unique par leur nom de modèle et leur nom de fichier au format MODEL_NAME::FILE_NAME.
Par exemple, le tableau de bord LookML défini dans le fichier sales_overview.dashboard.lkml du modèle appelé thelook aura l'URL suivante :
https://INSTANCE_URL/dashboards/thelook::sales_overview
Étant donné que le tableau de bord est identifié par le nom de fichier et le nom de modèle, vous ne pouvez pas avoir plusieurs tableaux de bord LookML avec le même nom de fichier dans différents dossiers s'ils font référence au même fichier de modèle. Si vous essayez de le faire, une erreur Duplicate Dashboard s'affiche.
Pour gérer des environnements distincts (tels que la révision et la production) sans dupliquer les fichiers, suivez ces bonnes pratiques :
- Utiliser des branches Git : au lieu de dupliquer des fichiers dans différents dossiers pour les tests, utilisez des branches Git pour isoler les modifications. Vous pouvez tester votre tableau de bord dans une branche de développement avant de le fusionner dans la branche de production.
- Contrôles d'accès au contenu : utilisez les niveaux d'accès aux dossiers pour contrôler les utilisateurs qui peuvent afficher ou modifier un contenu spécifique. Vous pouvez conserver un dossier "Production" pour les tableaux de bord validés et un dossier "Sandbox" ou "Révision" pour les travaux en cours, mais assurez-vous que chaque tableau de bord LookML possède un nom de fichier unique dans votre projet.
Convertir des Looks en vignettes de requête
Vous pouvez créer une vignette de tableau de bord en la reliant à un Look enregistré (également appelé vignette liée à un Look), en spécifiant du texte ou en définissant directement une requête. L'enregistrement de nombreux Looks nécessaires à un seul tableau de bord peut entraîner un encombrement. Pour éviter cela, vous pouvez convertir toutes les vignettes basées sur des Looks enregistrés en vignettes de requête.
Vous pouvez ensuite choisir de supprimer les Looks sources s'ils répondent aux critères suivants :
- Non utilisé dans un autre tableau de bord
- Non marqué comme favori
- Non planifié pour la livraison
- Non public
Pour convertir des Looks en vignettes de requête, procédez comme suit :
Dans la vue Liste, sélectionnez un ou plusieurs tableaux de bord dans votre dossier.
Sélectionnez le bouton Convertir les Looks en vignettes.
Dans la boîte de dialogue Convertir tous les Looks en vignettes , vous pouvez cocher la case pour déplacer les Looks dans la corbeille, puis passer le curseur sur le lien pour afficher la liste des Looks identifiés pour la suppression.
Looker n'affiche ce lien que s'il existe des Looks pouvant être supprimés en toute sécurité, par exemple ceux qui ne sont pas planifiés pour la livraison de données, qui ne sont pas utilisés dans d'autres tableaux de bord, qui ne sont pas marqués comme favoris ou qui ne sont pas publics.
Pour empêcher Looker de supprimer les Looks sources, assurez-vous que la case n'est pas cochée. Looker conservera tous les Looks pour le moment. Vous pourrez les supprimer manuellement ultérieurement pour libérer de l'espace dans vos dossiers.
Sélectionnez Convertir pour convertir toutes les vignettes liées à un Look du tableau de bord en vignettes de requête.
Looker remplace chaque vignette liée à un Look par une nouvelle vignette de requête utilisant les mêmes paramètres de requête et de visualisation que le Look d'origine. Si vous avez choisi de déplacer des Looks dans la corbeille, ces Looks convertis n'apparaissent plus dans les dossiers.
Si vous changez d'avis ultérieurement, votre administrateur Looker pourra peut-être récupérer un Look supprimé, sous réserve que l'équipe d'administrateurs Looker n'ait pas encore vidé la corbeille de Looker dans le cadre du processus de maintenance.
Supprimer des Looks et des tableaux de bord
Si vous disposez du niveau d'accès Gérer l'accès, Modifier pour un dossier, vous pouvez supprimer ses Looks et ses tableaux de bord.
- Cochez la case de chaque Look ou tableau de bord que vous souhaitez supprimer.
Cliquez sur Déplacer vers la corbeille.
Dans la fenêtre de confirmation, cliquez sur OK.
Si vous supprimez un Look qui est la source d'une vignette de tableau de bord, la vignette liée à un Look du tableau de bord renvoie une erreur Élément introuvable.
Pour les tableaux de bord, la fenêtre de confirmation peut afficher une option permettant de déplacer X Looks supplémentaires associés aux tableaux de bord ci-dessus dans la corbeille.
Lorsque cette option est sélectionnée, Déplacer X Looks supplémentaires associés aux tableaux de bord ci-dessus dans la corbeille supprime tous les Looks associés au tableau de bord. Toutefois, Looker ne supprime que les Looks qui ne sont pas planifiés pour la livraison de données, qui ne sont pas utilisés dans d'autres tableaux de bord, qui ne sont pas marqués comme favoris ou qui ne sont pas publics. Passez le curseur sur le lien affiché au bas de la fenêtre de confirmation pour afficher la liste des Looks identifiés pour la suppression.
Si l'option Déplacer X Looks supplémentaires associés aux tableaux de bord ci-dessus dans la corbeille ne s'affiche pas, cela signifie que Looker n'a identifié aucun Look pouvant être supprimé en toute sécurité.