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 pleinement 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) développée à l'aide du framework d'extension Looker et déployée via la Place de marché Looker.

L'extension Looker Data Dictionary fournit une interface dédiée et centralisée pour rechercher dans tous vos champs et descriptions Looker. Utilisez cette extension pour effectuer les tâches suivantes : * Fournir un répertoire consultable 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 externes d'identifier et de trouver facilement les métriques uniques. * Effectuez un audit des modèles LookML pour évaluer si des conventions de dénomination cohérentes sont respectées, s'il existe des champs redondants ou si des descriptions sont associées aux champs. * Ajouter et partager des commentaires sur des champs spécifiques (si votre application Data Dictionary de Looker est en 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 disponible pour les utilisateurs, vous pouvez effectuer les opérations 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 la place de marché, les administrateurs Looker doivent activer les fonctionnalités suivantes :

  • Place de marché : pour accéder à Marketplace Looker (activé 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) à partir de 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 d'accès 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 savoir comment accorder aux utilisateurs des autorisations d'accès et d'utilisation des extensions.

Accorder des autorisations pour interagir avec les commentaires de champs

Les commentaires sur les champs permettent aux utilisateurs d'ajouter du contexte aux définitions de champs sans avoir à modifier 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.

Si vous le souhaitez, les administrateurs Looker peuvent gérer la façon dont les utilisateurs interagissent avec la fonctionnalité de commentaire sur les champs en créant des groupes d'utilisateurs spécifiques sur la page Groupes du panneau Administration, puis en leur attribuant des utilisateurs. 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 ni interagir avec les commentaires. Toutes les fonctionnalités de commentaires sont désactivées. Les droits de ce groupe ont toujours la priorité sur ceux des autres groupes. Aucun utilisateur inclus dans le groupe disabled n'a accès à la fonctionnalité de commentaires, même s'il appartient également à un autre groupe disposant 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 voir tous les commentaires, en ajouter de nouveaux, et tous les modifier ou les supprimer.

Si un utilisateur n'appartient à aucun de ces groupes, la valeur par défaut est writer. Si un utilisateur est affecté à plusieurs groupes (à l'exception de marketplace_data_dictionary_comments_disabled), son droit le plus élevé prévaut.

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 de 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 de chaque champ. Sélectionnez les métadonnées à afficher en sélectionnant le bouton View Options (Options d'affichage). Consultez l'ensemble des métadonnées du champ dans l'outil de profilage des champs.
  8. Lignes contenant les métadonnées de chaque champ d'une vue donnée
  9. Navigation vers l'exploration de l'UI Looker

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

La liste déroulante Sélectionner un modèle affiche tous les modèles pour lesquels un utilisateur dispose d'autorisations explore. Lorsque vous sélectionnez 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 Rechercher dans le 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 sur lesquels filtrer, par exemple si le champ :

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ées 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 du dictionnaire de données est à la version 2.0.0 ou ultérieure pour pouvoir utiliser les commentaires au niveau du champ.

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 Dictionary peuvent consulter 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 champ.
  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 l'outil de profilage des champs. Vous pouvez développer le champ des commentaires en sélectionnant son coin inférieur droit et en le faisant glisser.

Une fois qu'un commentaire a été ajouté, il apparaît dans l'onglet Commentaires de l'outil de profilage des 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 commentaire contient les informations suivantes :

  • Nom du commentateur
  • Code temporel indiquant le moment où le commentaire a été ajouté
  • Aperçu du commentaire

Modifier ou supprimer un commentaire sur un 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, puis 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 intention.
  4. Si vous modifiez votre commentaire, sélectionnez Enregistrer une fois les modifications effectuées.

Partager un commentaire sur un 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 de la série de la dimension numérique.

Sous Valeurs, sélectionnez Calculer pour afficher un aperçu des valeurs de nombre 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.