Métadonnées pour les objets LookML

Les utilisateurs disposant de l'autorisation develop peuvent afficher des informations contextuelles pertinentes sur les objets dans le panneau des métadonnées de l'IDE Looker.

Pour afficher le panneau des métadonnées dans l'IDE Looker:

  1. Accédez aux fichiers de votre projet.
  2. Pour ouvrir le panneau d'aide rapide, sélectionnez l'icône Aide rapide .
  3. Dans l'éditeur de code LookML, placez votre curseur sur l'objet pour lequel vous souhaitez obtenir plus de contexte dans le panneau des métadonnées.
  4. Dans le panneau d'aide rapide, sélectionnez l'onglet Métadonnées pour ouvrir le panneau des métadonnées.

Le panneau des métadonnées identifie l'objet à l'aide d'un nom et d'une icône représentant son type (consultez la page de documentation Parcourir des projets à l'aide du panneau de navigation d'objets pour connaître toutes les icônes de type d'objet possibles).

Si un objet LookML est utilisé dans plusieurs modèles, le panneau des métadonnées comporte un menu déroulant qui vous permet de sélectionner le modèle dont vous souhaitez afficher les métadonnées.

Les informations affichées dans le panneau des métadonnées dépendent du type d'objet LookML que vous avez sélectionné, ainsi que de l'utilisation de l'objet sélectionné dans votre projet. Vous pouvez utiliser les métadonnées pour mieux comprendre de nombreux aspects de votre projet, comme décrit dans les sections suivantes.

Métadonnées pour les modèles

Si vous sélectionnez un fichier de modèle, le panneau des métadonnées affiche les sections suivantes:

  • Tableaux de bord: répertorie tous les tableaux de bord LookML inclus dans le modèle, avec des liens vers leurs définitions dans votre projet LookML.
  • Explorations: répertorie toutes les explorations incluses dans le modèle, avec des liens vers leurs définitions dans votre projet LookML.
  • Vues: répertorie toutes les vues incluses dans le modèle, avec des liens vers leurs définitions dans votre projet LookML.

L'en-tête de chaque section indique également le numéro de chaque type d'objet.

Métadonnées pour les vues

Si vous sélectionnez un paramètre de vue, le panneau des métadonnées affiche les informations suivantes sur l'utilisation de la vue dans votre projet:

  1. Nom et détails de la vue: nom de la vue et icône représentant le type d'objet de la vue. Pour connaître toutes les icônes de type d'objet possibles, consultez la page de documentation Parcourir des projets à l'aide du panneau du navigateur d'objets. Le panneau des métadonnées indique également le nom du fichier et le numéro de la ligne où la vue est définie dans le code LookML du fichier (ainsi qu'un lien vers la vue de votre projet).
  2. Utilisé dans le menu [nombre] modèles: affiche la liste des modèles qui incluent cette vue, où [nombre] représente le nombre de modèles qui incluent cette vue. Par exemple, si une vue est utilisée dans deux modèles, le panneau des métadonnées affiche le texte Utilisé dans deux modèles.
  3. Clé primaire: clé primaire de la vue.
  4. Vue de base de: explorations utilisant cette vue comme vue de base.
  5. Joined in: explore les éléments dans lesquels cette vue est jointe.

Si la vue comporte des extensions ou des améliorations, celles-ci sont également affichées dans le panneau des métadonnées.

Métadonnées pour les explorations

Si vous sélectionnez un paramètre explore, le panneau des métadonnées affiche les informations suivantes sur l'utilisation de l'exploration dans votre projet:

  1. Nom et détails de l'exploration: nom de l'exploration et icône représentant son type d'objet (pour connaître toutes les icônes de type d'objet disponibles, consultez la page de documentation Parcourir des projets avec le panneau de navigation d'objets). Le panneau des métadonnées indique également le nom du fichier et le numéro de la ligne où l'exploration est définie dans le code LookML du fichier (et un lien vers l'exploration dans votre projet).
  2. Vue de base: la vue de base de l'exploration (la vue utilisée comme point de départ pour créer l'exploration).
  3. Vues jointes: autres vues jointes dans la vue de base.

Si l'exploration comporte des extensions ou des améliorations, celles-ci s'affichent également dans le panneau des métadonnées.

Métadonnées pour les champs

Si vous sélectionnez un champ, le panneau des métadonnées affiche les informations suivantes sur son utilisation dans votre projet:

  1. Nom du champ et détails: nom du champ et icône représentant son type d'objet. Pour connaître toutes les icônes de type d'objet disponibles, consultez la page de documentation Parcourir des projets avec le panneau de navigation d'objets. Le panneau des métadonnées indique également le type du champ, ainsi que le nom du fichier et le numéro de la ligne où le champ est défini dans le code LookML du fichier (ainsi qu'un lien vers le champ dans votre projet).
  2. Utilisé dans le menu [nombre] modèles: affiche la liste des modèles qui incluent la vue de ce champ.
  3. Existe dans la vue: vues qui utilisent ce champ.

Métadonnées pour les extensions

Lorsque vous sélectionnez un paramètre view ou explore dans l'éditeur de code LookML, la section Étendue par du panneau des métadonnées affiche toutes les extensions de cet objet.

Prenons l'exemple de code LookML suivant pour un fichier de modèle dans lequel l'exploration aircraft_extended étend l'exploration aircraft:

explore: aircraft {
  view_name: aircraft
  join: aircraft_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_type_id} = ${aircraft_types.aircraft_type_id} ;;
    relationship: many_to_one
  }

  join: aircraft_engine_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_engine_type_id} = ${aircraft_engine_types.aircraft_engine_type_id} ;;
    relationship: many_to_one
  }
}

explore: aircraft_extended {
  extends: [aircraft]
  label: "Aircraft Extended"
}

Si vous sélectionnez la définition LookML pour l'exploration aircraft, le panneau des métadonnées répertorie aircraft_extended dans la section Étendue par. Cliquez sur le lien dans la section Extended by (Étendu par) pour accéder directement au LookML où aircraft_extended est défini.

Si vous cliquez sur la définition de l'exploration aircraft_extended, le panneau des métadonnées fournit les informations suivantes sur l'exploration aircraft étendue:

  • Vues jointes: répertorie toutes les vues associées à l'exploration aircraft.
  • Extension: indique l'objet étendu par l'exploration sélectionnée. Dans ce cas, il s'agit de l'exploration aircraft.

Dans ces exemples, les paramètres d'extension et d'explore étendus sont côte à côte dans le même fichier, mais ce n'est pas toujours le cas. Ce n'est pas évident en recherchant un paramètre s'il est étendu, d'autant que les objets étendus et étendus peuvent se trouver dans différents fichiers LookML. Le panneau des métadonnées vous fournit du contexte sur les objets associés, quel que soit l'endroit où ils sont définis.

Métadonnées pour les suggestions

Le panneau des métadonnées permet de voir facilement si une vue ou une exploration comporte des affinements qui ont été ajoutés à l'objet. La section Filtres du panneau des métadonnées affiche le nombre de perfectionnements qui ont été ajoutés à l'objet. Vous pouvez également utiliser les liens pour accéder au LookML pour chaque amélioration.

Comme avec les extensions, vous ne pouvez pas savoir si un objet est affiné simplement en regardant le code LookML, notamment parce que le code LookML d'affinement peut se trouver dans un autre fichier. Le panneau des métadonnées vous permet de voir si un objet a été affiné et, le cas échéant, d'accéder directement au LookML pour l'affiner.

Métadonnées des projets importés

Le panneau des métadonnées comprend des informations sur les objets des projets importés, y compris des liens permettant d'accéder au fichier importé dans lequel les objets sont définis. Par exemple, si vous sélectionnez le LookML pour une exploration basée sur un fichier de vue importé, les informations sur le fichier de vue importé s'afficheront dans le panneau des métadonnées.

Dans le panneau des métadonnées, vous pouvez cliquer sur le lien pour accéder au fichier importé dans lequel l'objet est défini.

De plus, vous pouvez cliquer sur les objets qui se trouvent dans le dossier des projets importés dans le navigateur de fichiers de l'IDE pour afficher les métadonnées sur les fichiers importés.