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 suivre les étapes suivantes:

  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.

Installer le 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)
  • Framework d'extension: permet de 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.

Pour savoir comment installer un outil depuis Looker Marketplace, consultez la documentation Utiliser Looker Marketplace. Pour vous assurer de toujours disposer de la version la plus récente du dictionnaire de données, accédez à la place de marché Looker, sélectionnez Gérer, puis 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 New Model Set (Nouvel ensemble de modèles) et Edit Model Set (Modifier l'ensemble de modèles), accessibles depuis la page Roles (Rôles) du panneau Admin (Administration).

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

Accorder des autorisations pour interagir avec les commentaires de champ

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 Dictionary peuvent consulter 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. Pour savoir comment attribuer des utilisateurs à des groupes, consultez la page de documentation Groupes.

Les groupes d'utilisateurs doivent être créés avec les noms prédéfinis indiqués dans la colonne "Nom du groupe" du tableau suivant. Le tableau indique également les droits prédéfinis dont disposeront les utilisateurs attribués à chaque groupe.

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 voir tous les commentaires, en ajouter, et modifier/supprimer les leurs. Il s'agit du privilège par défaut.
marketplace_data_dictionary_comments_manager Les utilisateurs peuvent voir tous les commentaires, en ajouter, et 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 attribué à plusieurs groupes (à l'exception de marketplace_data_dictionary_comments_disabled), l'autorisation la plus élevée prévaut.

Les modifications apportées à un groupe de commentaires (par exemple, l'ajout ou la suppression d'un utilisateur) via la page Groupes du panneau Administration prennent effet après un actualisation forcée de la page du dictionnaire de données ou après que l'utilisateur a sélectionné une autre option, puis est revenu sur la page du 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 du 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 de 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. Exploration 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 cliquant sur le bouton Afficher les options. 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. Accéder à l'exploration dans l'interface utilisateur de Looker

Sélectionner un modèle et 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 choisissez un modèle dans le menu déroulant Sélectionner un modèle, la barre latérale de gauche affiche la liste des explorations de ce modèle.

Vous pouvez également rechercher une exploration spécifique dans le modèle sélectionné en saisissant le nom de l'exploration 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 dans une exploration

Vous pouvez filtrer les champs affichés en saisissant du texte dans le champ Filtrer les champs de cette exploration pour qu'il corresponde au Libellé du champ ou à la Description de la liste des champs.

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 des champs

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 en haut à droite, puis en cochant ou en décochant les cases correspondant aux métadonnées que vous souhaitez 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 du 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 du champ pour afficher une icône + (si aucun commentaire n'est associé au champ) ou une icône de bloc-notes (si des commentaires sont associés au champ). 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 l'enregistrer. 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 sur les champs

Lorsqu'un champ inclut des commentaires, une icône de bloc-notes s'affiche avec le nombre de commentaires associés à ce champ. Cliquez sur l'icône du bloc-notes pour afficher les commentaires du champ dans l'onglet Commentaires de l'outil de profilage des champs.

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

  • Nom du commentateur
  • Code temporel indiquant la date et l'heure d'ajout du commentaire
  • Aperçu du commentaire

Modifier ou supprimer un commentaire sur un champ

Pour modifier ou supprimer vos propres commentaires sur un champ:

  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, puis 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 qui ont accès à ce modèle dans le Data Dictionary de Looker.

Utiliser le profileur de champ

Cliquez sur une ligne de champ spécifique pour ouvrir un panneau de profilage de champ qui affiche l'ensemble complet de métadonnées du champ, des options permettant d'afficher un aperçu des valeurs de dimension numérique et des boutons permettant d'accéder à l'IDE Looker ou à la page Explorer.

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

Dans la section Distribution, sélectionnez Calculer pour afficher un aperçu d'un graphique en colonnes illustrant la distribution des valeurs de nombre pour les dimensions numériques dans une vue avec une mesure contenant 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 dans une vue avec une mesure contenant type: count. Sélectionnez le bouton Explorer plus pour ouvrir l'interface utilisateur d'exploration avec la dimension numérique et la mesure de nombre présélectionnées dans le sélecteur de champ.

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

Sélectionnez le bouton Explorer avec un champ pour ouvrir la page Explorer avec ce champ automatiquement sélectionné dans le sélecteur de champ.