Utiliser le dictionnaire de données Looker

Le dictionnaire de données Looker est différent du bloc de dictionnaire de données.

Pour profiter de toutes les fonctionnalités de l'extension Looker Data Dictionary, les administrateurs doivent mettre à jour l'application Looker Data Dictionary vers la version 2.0.0 ou ultérieure.

Le dictionnaire de données Looker est une extension, une application Web créée à l'aide de composants Looker. Elle est développée à l'aide du framework d'extension Looker et déployée via Looker Marketplace.

L'extension Looker Data Dictionnaire fournit une interface dédiée et centralisée pour effectuer des recherches dans tous vos champs et descriptions Looker. Utilisez cette extension pour effectuer les tâches suivantes: * Fournissez un répertoire inclus dans l'index de recherche pour toutes les métriques et descriptions, afin que les utilisateurs puissent identifier la dimension ou la mesure appropriée pour l'analyse. * Permettre aux personnes concernées externes d'identifier et de localiser facilement des indicateurs uniques * Auditer les modèles LookML pour déterminer si des conventions d'attribution de noms cohérentes sont respectées, s'il existe des champs redondants ou si les champs sont annotés avec des descriptions. * Ajouter et partager des commentaires sur des champs spécifiques (si votre application Looker Data Dictionnaire utilise la version 2.0.0 ou ultérieure).

Pour que les utilisateurs puissent accéder au dictionnaire de données Looker et l'utiliser, les administrateurs Looker doivent procéder comme suit:

  1. Activez les fonctionnalités appropriées.
  2. Installez l'extension Looker Data Dictionary.
  3. Accordez des autorisations pour accéder au dictionnaire de données Looker.

Une fois l'extension mise à la disposition des utilisateurs, vous pouvez effectuer les actions suivantes:

  1. Accédez au dictionnaire de données Looker.
  2. Affichez les métadonnées de votre modèle.

Installation du dictionnaire de données Looker

Avant d'installer le dictionnaire de données Looker depuis Marketplace, les administrateurs Looker doivent activer les fonctionnalités suivantes:

  • Marketplace: pour accéder à la place de marché Looker (option activée par défaut)
  • Extension Framework: pour déployer des extensions développées à l'aide du framework d'extension Looker (activé par défaut)

Pour installer des applications et des outils, tels que des extensions, depuis Marketplace, vous devez disposer des autorisations develop, manage_models et deploy.

Consultez la documentation Utiliser Marketplace Looker pour savoir comment installer un outil depuis cet outil. Pour vous assurer de toujours disposer de la version la plus récente du dictionnaire de données, accédez à Looker Marketplace, sélectionnez Gérer, puis cliquez sur le bouton Mettre à jour à côté de l'extension.

Accorder des autorisations pour accéder au dictionnaire de données Looker

Une fois le dictionnaire de données Looker installé, un modèle appelé data-dictionary est automatiquement ajouté à la liste des modèles disponibles sur les pages Nouvel ensemble de modèles et Modifier l'ensemble de modèles, accessibles depuis la page Rôles du panneau Administration.

Les administrateurs Looker doivent accorder aux utilisateurs l'autorisation explore ou develop pour accéder au modèle data-dictionary et à tous les modèles qu'ils doivent explorer dans le dictionnaire de données. Consultez la page de documentation Définir des autorisations pour les extensions Looker pour découvrir comment accorder des autorisations aux utilisateurs pour accéder aux extensions et les utiliser.

Accorder des autorisations pour interagir avec les commentaires de champs

Les commentaires de champ permettent aux utilisateurs d'ajouter du contexte aux définitions de champs sans avoir à mettre à jour le code LookML. Par défaut, tous les utilisateurs ayant accès à l'extension Data Dictionnaire pourront voir tous les commentaires, et ajouter, modifier et supprimer leurs propres commentaires.

S'ils le souhaitent, les administrateurs Looker peuvent gérer la façon dont les utilisateurs interagissent avec la fonctionnalité de commentaires de champ en créant des groupes d'utilisateurs spécifiques sur la page Groupes du panneau Administration et en attribuant des utilisateurs à ces groupes. Consultez la page de documentation Groupes pour savoir comment attribuer des utilisateurs à des groupes.

Les groupes d'utilisateurs doivent être créés avec les noms prédéfinis qui sont affichés dans la colonne Nom du groupe du tableau suivant. Le tableau indique également les droits prédéfinis que les utilisateurs affectés à chaque groupe auront.

Nom du groupe Droits
marketplace_data_dictionary_comments_disabled les utilisateurs ne peuvent pas voir les commentaires ni interagir avec ceux-ci ; toutes les fonctionnalités de commentaires sont désactivées. Les droits de ce groupe prévalent toujours sur ceux des autres groupes. Les utilisateurs inclus dans le groupe disabled n'auront pas accès à la fonctionnalité de commentaires, même s'ils appartiennent également à un autre groupe doté de droits plus élevés.
marketplace_data_dictionary_comments_reader L'utilisateur peut voir les commentaires existants, mais ne peut pas en ajouter.
marketplace_data_dictionary_comments_writer Les utilisateurs peuvent consulter tous les commentaires, en ajouter de nouveaux et modifier ou supprimer les leurs. Il s'agit du droit par défaut.
marketplace_data_dictionary_comments_manager Les utilisateurs peuvent consulter tous les commentaires, en ajouter, et tous les modifier ou les supprimer.

Si un utilisateur n'appartient à aucun de ces groupes, il est associé par défaut à writer. Si un utilisateur est affecté à plusieurs groupes (à l'exception de marketplace_data_dictionary_comments_disabled), ses droits les plus élevés prévalent.

Les modifications apportées à un groupe de commentaires (ajout ou suppression d'un utilisateur, par exemple) effectuées via la page Groupes du panneau Administration prennent effet après une actualisation forcée de la page "Dictionnaire de données" ou lorsque l'utilisateur sélectionne une autre option, puis revient à la page "Dictionnaire de données".

Vous pouvez accéder au dictionnaire de données à partir de la liste des applications et extensions installées dans la barre latérale gauche.

Afficher les métadonnées d'un modèle avec le dictionnaire de données Looker

Dans le dictionnaire de données Looker, les utilisateurs disposant d'autorisations explore sur un modèle peuvent sélectionner ce modèle et afficher ses métadonnées, y compris ses explorations et la liste des champs de chaque exploration, regroupés par vue. Le dictionnaire de données Looker affiche les explorations du modèle sélectionné dans la barre latérale gauche, ainsi que les vues et les champs de l'exploration sélectionnée dans la partie principale de la page.

Les utilisateurs peuvent réduire la barre latérale en sélectionnant l'icône <.

Le dictionnaire de données Looker affiche les informations suivantes:

  1. Nom du modèle sélectionné
  2. Liste des explorations contenues dans le modèle sélectionné
  3. Explorer sélectionnée
  4. Champ de texte permettant de filtrer les champs d'une exploration
  5. Filtres rapides pour affiner les champs affichés en fonction des caractéristiques sélectionnées
  6. Nom de la vue
  7. Métadonnées sur chaque champ. Sélectionnez les métadonnées à afficher en cliquant sur le bouton Options d'affichage. Consultez l'ensemble complet des métadonnées du champ dans le Profileur de champ.
  8. Lignes contenant les métadonnées de chaque champ d'une vue donnée
  9. Navigation vers l'exploration dans l'interface utilisateur de Looker

Sélection d'un modèle et d'une exploration

La liste déroulante Sélectionner un modèle répertorie tous les modèles pour lesquels un utilisateur dispose d'autorisations explore. Lorsque vous choisissez un modèle dans le menu déroulant Sélectionner un modèle, la liste des explorations de ce modèle s'affiche dans la barre latérale de gauche.

Vous pouvez également rechercher une exploration spécifique dans le modèle sélectionné en saisissant du texte dans le champ de recherche Rechercher un modèle. La liste des explorations est filtrée pour n'afficher que les résultats correspondant à vos termes de recherche.

Sélectionnez le nom d'une exploration pour afficher ses champs, regroupés par vue, dans la partie principale de la page.

Vous pouvez également sélectionner le bouton Explorer en haut à droite pour accéder directement à la page Explorer dans Looker.

Filtrer les champs d'une exploration

Vous pouvez filtrer les champs affichés en saisissant du texte dans la zone Filtrer les champs de cette exploration pour le faire correspondre à la liste des champs Libellé du champ ou Description :

Vous pouvez également sélectionner des attributs de métadonnées spécifiques à filtrer, par exemple:

Afficher les métadonnées d'un champ

Le dictionnaire de données Looker affiche les métadonnées des champs d'une exploration, regroupés par vue:

Personnaliser les métadonnées affichées

Vous pouvez spécifier les métadonnées à afficher pour chaque champ en sélectionnant le bouton Options d'affichage dans l'angle supérieur droit, puis en cochant ou décochant les cases correspondant aux métadonnées à afficher.

Utiliser des commentaires de champ

Si une instance dispose déjà de Marketplace, les administrateurs doivent s'assurer que l'extension Data Dictionnaire est version 2.0.0 ou ultérieure pour utiliser les commentaires au niveau des champs.

Les développeurs LookML incluent souvent des informations ou des explications supplémentaires sur les champs d'un modèle dans le paramètre description au niveau du champ. Cependant, ces descriptions ne sont pas toujours pertinentes ni utiles pour tous les utilisateurs. Les commentaires au niveau d'un champ permettent aux utilisateurs d'ajouter du contexte à un champ spécifique. Ces commentaires sont visibles par les autres utilisateurs, mais n'affectent pas le code LookML sous-jacent du modèle.

Les administrateurs doivent autoriser les utilisateurs à interagir avec les commentaires en les ajoutant à des groupes spécifiques sur la page Groupes du panneau Administration. Par défaut, tous les utilisateurs ayant accès à l'extension Data Dictionnaire peuvent afficher tous les commentaires et ajouter, modifier et supprimer leurs propres commentaires.

Ajouter un commentaire de champ

Pour ajouter un commentaire à un champ:

  1. Pointez sur la ligne d'un champ pour afficher une icône + (s'il n'existe pas de commentaires de champ) ou une icône de bloc-notes (si un champ contient déjà des commentaires). Cliquez sur l'icône pour ouvrir l'onglet Commentaires du panneau du profileur de champs.
  2. Cliquez sur le bouton Ajouter un commentaire.
  3. Saisissez votre commentaire, puis sélectionnez le bouton Commenter pour enregistrer le commentaire. Cliquez sur Annuler pour fermer le profileur de champ. Vous pouvez développer la zone de commentaires en sélectionnant l'angle inférieur droit et en le faisant glisser.

Une fois qu'un commentaire a été ajouté, il apparaît dans l'onglet Commentaires du profileur de champs et est visible par les autres utilisateurs.

Afficher les commentaires d'un champ

Lorsqu'un champ contient des commentaires, une icône en forme de bloc-notes s'affiche avec le nombre de commentaires présents dans ce champ. Cliquez sur l'icône en forme de bloc-notes pour afficher les commentaires du champ répertoriés dans l'onglet Commentaires du profileur de champ.

Le nombre de commentaires dans ce champ est également indiqué entre parenthèses dans l'onglet Commentaires. Chaque entrée de commentaire affiche les informations suivantes:

  • Nom de l'auteur du commentaire
  • Code temporel indiquant le moment où le commentaire a été ajouté
  • Aperçu du commentaire

Modifier ou supprimer un commentaire de champ

Pour modifier ou supprimer vos propres commentaires de champs:

  1. Sélectionnez l'icône du bloc-notes du champ.
  2. Dans l'onglet Commentaires, recherchez le commentaire que vous souhaitez modifier ou supprimer et pointez dessus.
  3. Cliquez sur le menu à trois points et sélectionnez Modifier le commentaire pour le modifier ou Supprimer le commentaire pour le supprimer. Si vous supprimez le commentaire, confirmez votre choix.
  4. Lorsque vous apportez des modifications à votre commentaire, sélectionnez Enregistrer.

Partager un commentaire de champ

L'URL de l'onglet Commentaires de chaque champ est unique. Vous pouvez la copier et la partager avec d'autres utilisateurs ayant accès à ce modèle dans le dictionnaire de données Looker.

Utiliser le Profileur de champ

Cliquez sur une ligne de champ spécifique pour ouvrir un panneau de profileur de champ qui affiche l'ensemble des métadonnées du champ, des options permettant de prévisualiser les valeurs de dimension numérique et des boutons pour accéder à l'IDE Looker ou à la page Explorer.

Si vous utilisez la version 2.0.0 ou une version ultérieure de l'extension Looker Data Dictionnaire, le profileur de champ s'ouvre par défaut sur l'onglet Détails.

Dans la section Distribution, sélectionnez Calculate (Calculer) pour afficher un aperçu d'un graphique à colonnes illustrant la distribution des valeurs de nombre pour les dimensions numériques sur une vue avec une mesure comportant type: count. La section Distribution affiche également les valeurs minimale, maximale et moyenne des séries de dimensions numériques.

Sous Valeurs, sélectionnez Calculer pour afficher un aperçu des valeurs de décompte pour les dimensions numériques sur une vue avec une mesure comportant type: count. Sélectionnez le bouton Explore More (Plus d'explorations) pour ouvrir l'interface utilisateur Explorer. La dimension numérique et la mesure de nombre sont présélectionnées à partir du sélecteur de champs.

Sélectionnez Accéder à LookML pour ouvrir le fichier de vue du projet LookML associé au modèle sélectionné dans l'IDE Looker.

Cliquez sur le bouton Explorer avec le champ pour ouvrir la page Explorer avec ce champ automatiquement sélectionné dans le sélecteur de champs.