Modéliser vos données en LookML

Découvrez comment utiliser LookML et l'IDE Looker pour modéliser vos données de manière structurée et réutilisable.

Le moyen le plus simple de modéliser vos données dans Looker consiste à laisser Looker générer automatiquement des fichiers LookML basés sur les tables de votre base de données. Pour vous entraîner, consultez le guide de démarrage rapide Générer un modèle à partir d'exemples de données. La procédure complète est disponible sur la page de documentation Générer un modèle LookML.

L'objectif de ce guide de démarrage rapide est de vous montrer comment ajouter manuellement des fichiers LookML à votre projet et comment créer manuellement des éléments LookML afin de personnaliser votre projet LookML en fonction de vos données et de vos besoins spécifiques. Ce guide de démarrage rapide vous explique comment créer manuellement un fichier de modèle LookML et un fichier de vue LookML, créer une exploration pour votre vue, créer une dimension dans votre fichier de vue et tester votre nouvelle mesure dans l'interface utilisateur Explorer. Ce guide de démarrage rapide vous explique également comment activer le mode Développement, parcourir l'IDE Looker et utiliser la fonctionnalité d'aide rapide de l'IDE Looker. Ce guide de démarrage rapide fournit également des liens vers la documentation pertinente pour en savoir plus sur ces sujets.

Pour commencer, ce guide de démarrage rapide utilise l'exemple de projet LookML qui est automatiquement configuré sur les instances Looker (Google Cloud Core).

Avant de commencer

Pour suivre ce guide de démarrage rapide, vous aurez besoin des éléments suivants :

  • Accès à une instance Looker (Google Cloud Core) :

Rôles requis

Pour suivre ce guide de démarrage rapide, vous devez disposer du rôle IAM (Identity and Access Management) et du rôle Looker appropriés.

Rôles de gestion de l'authentification et des accès (IAM)

Votre administrateur Looker (Google Cloud Core) vous accorde l'accès à l'application Looker (Google Cloud Core) via le système Identity and Access Management de Google Cloud.

Pour obtenir l'autorisation dont vous avez besoin pour accéder à l'application Looker (Google Cloud Core), demandez à votre administrateur de vous accorder le rôle IAM Utilisateur de l'instance Looker (roles/looker.instanceUser) sur le projet Google Cloud contenant l'instance Looker (Google Cloud Core). Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation looker.instances.login, qui est nécessaire pour accéder à l'application Looker (Google Cloud Core).

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Autorisations Looker

Vous devez disposer d'un compte utilisateur Looker avec le rôle Administrateur Looker ou l'autorisation develop.

Activer le mode Développement

Les projets Looker peuvent exister dans l'un des deux modes suivants : mode Production et mode Développement. Le mode Développement vous permet de modifier des fichiers LookML et de prévisualiser l'impact de ces modifications sur le contenu de votre instance sans affecter l'environnement de production (ce que voient les autres utilisateurs). Pour en savoir plus, consultez la page de documentation Mode Développement et mode Production.

Pour ce guide de démarrage rapide, vous allez utiliser le mode Développement afin de pouvoir modifier les fichiers LookML et tester vos modifications dans une exploration.

Pour activer le mode Développement, procédez comme suit :

  1. Sur la page d'accueil de Looker (Google Cloud Core), cliquez sur l'icône Menu principal de Looker  pour développer le menu de navigation principal, s'il ne l'est pas déjà.
  2. Sélectionnez le bouton bascule Mode Développement en bas du menu.

Lorsque le mode Développement est activé, Looker affiche la bannière Mode Développement en haut de l'écran.

Un projet LookML est un ensemble de fichiers LookML qui indiquent à Looker comment se connecter à votre base de données, comment interroger vos données et comment les présenter dans l'interface utilisateur. Dans ce guide de démarrage rapide, vous allez utiliser l'exemple de projet LookML qui est automatiquement configuré sur les instances Looker (Google Cloud Core).

Pour accéder aux exemples de fichiers de projet LookML dans l'IDE Looker, procédez comme suit :

  1. Cliquez sur l'icône Menu principal  de Looker, puis sélectionnez Développer si le menu Développer n'est pas déjà affiché.
  2. Dans le menu Développer, sélectionnez sample_thelook_ecommerce.

Looker ouvre le panneau Explorateur de fichiers de l'IDE Looker et affiche les fichiers de l'exemple de projet LookML.

Créer un dossier de projet

Pour séparer les fichiers que vous créez dans ce guide de démarrage rapide du reste des fichiers du projet LookML exemple, vous allez créer un dossier de projet pour les fichiers du guide de démarrage rapide.

Pour créer un dossier dans votre projet, procédez comme suit :

  1. Dans le panneau Navigateur de fichiers de l'IDE Looker, cliquez sur l'icône Ajouter un fichier ou un dossier en haut du panneau, puis sélectionnez l'option Créer un dossier dans le menu Ajouter un fichier ou un dossier.

  2. Pour le nom du nouveau dossier, saisissez quickstart.

  3. Cliquez sur Créer.

Looker ajoute le nouveau dossier au panneau Explorateur de fichiers de l'IDE Looker.

Informations supplémentaires sur les dossiers IDE

Pour en savoir plus sur l'utilisation des dossiers dans votre projet LookML, consultez les pages de documentation suivantes :

Créer un fichier de modèle LookML

Un fichier de modèle LookML spécifie une connexion de base de données et l'ensemble des explorations Looker qui utilisent cette connexion. Une exploration est un point de départ permettant à vos utilisateurs d'interroger vos données dans Looker une fois qu'elles ont été modélisées dans LookML (voir Afficher et interagir avec les explorations dans Looker).

Pour créer un fichier de modèle dans votre projet LookML, procédez comme suit :

  1. Dans le panneau Navigateur de fichiers de l'IDE Looker, sélectionnez le menu à trois points Options du dossier pour le dossier quickstart que vous avez créé dans la procédure Créer un dossier de projet.
  2. Dans le menu Options du dossier, sélectionnez Créer un modèle.
  3. Dans la boîte de dialogue Créer un fichier, saisissez le nom quickstart_practice pour le nouveau fichier, puis cliquez sur Créer. Looker crée le fichier quickstart_practice.model dans le dossier quickstart et l'ouvre dans l'IDE Looker. Le point bleu à côté du fichier dans le panneau Explorateur de fichiers indique que le fichier est nouveau.
  4. Dans le panneau Explorateur de fichiers, cliquez sur le dossier quickstart pour le développer et afficher le fichier quickstart_practice.model.
  5. Dans l'IDE Looker, cliquez sur le fichier quickstart_practice.model pour l'ouvrir s'il ne l'est pas déjà.

Le fichier quickstart_practice.model contient un exemple de code LookML que vous pouvez utiliser comme point de départ pour votre projet. Pour l'instant, vous pouvez conserver le fichier tel quel. Plus loin dans le démarrage rapide, vous créerez des explorations dans votre fichier de modèle.

Informations supplémentaires sur les fichiers de modèle

Pour créer vos propres fichiers de modèle à l'avenir, consultez les ressources suivantes :

Créer un fichier de vue LookML

Dans LookML, une vue correspond à une seule table de votre base de données ou à une seule table dérivée. Le fichier de vue spécifie la table de votre base de données à interroger et les champs (dimensions et mesures) à inclure à partir de cette table. Une fois que vous avez défini un champ dans le fichier de vue, vous pouvez utiliser l'opérateur de substitution $ pour référencer le champ dans d'autres parties de votre code LookML. Cela vous permet de définir le champ à un seul endroit tout en l'utilisant à plusieurs endroits dans votre projet LookML.

Il existe plusieurs façons de créer un fichier de vue, mais la plus simple pour commencer est de demander à Looker de générer automatiquement un fichier de vue basé sur une table existante dans votre base de données.

Pour que Looker génère un fichier de vue, procédez comme suit :

  1. Dans le panneau Navigateur de fichiers de l'IDE Looker, sélectionnez le menu à trois points Options du dossier pour le dossier quickstart que vous avez créé dans la procédure Créer un dossier de projet.
  2. Sélectionnez Créer une vue à partir d'une table dans le menu Options du dossier.

  3. Sur la page Créer des vues à partir de tables, cliquez sur le champ de saisie Saisir une base de données personnalisée et saisissez bigquery-public-data :

    Boîte de dialogue "Créer des vues à partir de tables".

  4. Appuyez sur Entrée pour afficher les ensembles de données publics BigQuery.

  5. Faites défiler la liste jusqu'à trouver l'ensemble de données thelook_ecommerce.

  6. Cliquez sur l'ensemble de données thelook_ecommerce pour le développer.

  7. Sélectionnez la table order_items.

  8. Cliquez sur le bouton Créer des vues en bas de la page.

Looker affiche le fichier de vue order_items dans l'IDE Looker. Dans le panneau "Explorateur de fichiers", le dossier quickstart est développé et le fichier de vue order_items s'affiche avec un point bleu pour indiquer qu'il s'agit d'un nouveau fichier.

Informations supplémentaires sur l'affichage des fichiers

Pour créer vos propres fichiers de vue à l'avenir, consultez les ressources suivantes :

Aide rapide de l'IDE Looker

Vous avez créé un fichier de modèle LookML et un fichier de vue LookML. Dans les prochaines étapes de ce guide de démarrage rapide, vous allez commencer à modifier ces fichiers. Avant de commencer à modifier des fichiers, familiarisez-vous avec la fonctionnalité Aide rapide de l'IDE Looker. Le panneau Aide rapide fournit des explications et des options pour l'emplacement actuel du curseur dans vos fichiers LookML :

  • Dans le panneau de l'éditeur de l'IDE, vous pouvez cliquer sur les champs et les paramètres de vos fichiers LookML. Le panneau Aide rapide affichera les options et les sous-paramètres compatibles pour cet élément LookML.
  • Dans le panneau Aide rapide, vous pouvez cliquer sur le nom d'un paramètre pour ouvrir la page de documentation Looker correspondante.

Si le panneau Aide rapide n'est pas déjà ouvert, vous pouvez l'ouvrir en cliquant sur l'icône Aide rapide dans l'IDE Looker :

Créer des explorations pour vos vues

Après avoir suivi les procédures Créer un fichier de modèle LookML et Créer un fichier de vue LookML, vous pouvez définir une exploration pour votre nouveau fichier de vue afin d'utiliser Looker pour interroger les données que vous avez modélisées dans le fichier de vue.

Les explorations sont généralement définies dans un fichier de modèle. (Vous pouvez créer un fichier Explore distinct, mais pour les besoins de ce guide de démarrage rapide, vous allez créer l'exploration dans le fichier de modèle.)

Dans le fichier LookML où vous définissez une exploration, vous devez utiliser le paramètre include pour pouvoir faire référence au fichier de vue dans la définition de l'exploration. Cette procédure vous guide tout au long de ces étapes.

Pour créer une exploration pour le fichier de vue order_items, procédez comme suit :

  1. Dans l'IDE Looker, ouvrez le fichier quickstart_practice.model.

  2. Dans le fichier quickstart_practice.model, remplacez la ligne existante contenant le paramètre include par la ligne suivante :

    include: "/quickstart/order_items.view"

  3. Ajoutez une ligne sous le paramètre include et saisissez la valeur LookML suivante, que vous pouvez sélectionner dans le champ none explore: order_items {} :

  4. Cliquez sur le bouton Enregistrer les modifications en haut de l'IDE Looker.

Cette exploration est l'exemple le plus élémentaire d'exploration permettant aux utilisateurs d'interroger la vue order_items. À partir de ce point de départ, vous pouvez développer votre exploration de nombreuses façons.

Informations supplémentaires sur les explorations

Pour créer vos propres explorations à l'avenir et les développer, consultez les ressources suivantes :

Créer un champ

Après avoir créé les fichiers de vue dans la section Créer un fichier de vue LookML de ce guide de démarrage rapide, vous pouvez voir les champs que Looker a créés automatiquement. Lorsque vous créez un fichier de vue basé sur une table de base de données, Looker crée automatiquement des dimensions, des groupes de dimensions et des mesures :

  • Une dimension est un champ qui représente un attribut, un fait ou une valeur. Les utilisateurs peuvent la sélectionner dans le sélecteur de champ d'une exploration et l'utiliser pour filtrer une requête. Si le champ ne se trouve pas dans une fonction d'agrégation (SUM, COUNT, etc.), il s'agit d'une dimension. Looker crée automatiquement une dimension pour chaque colonne de votre table de base de données.
  • Un groupe de dimensions permet de créer un ensemble de dimensions temporelles ou de durée en une seule fois. Par exemple, le groupe de dimensions d'une colonne d'horodatage contient des dimensions individuelles pour la date, le mois, le trimestre, l'heure, la semaine et l'année. Looker crée automatiquement un groupe de dimensions pour les champs basés sur le temps qu'il détecte dans la table de votre base de données.
  • Une mesure est un champ dans une exploration qui représente des informations mesurables sur vos données, telles que des sommes, des nombres, etc. Une mesure est déclarée dans un fichier de vue et peut être de type agrégé ou non agrégé. Looker crée automatiquement une mesure type:count pour votre fichier de vue, ce qui équivaut à un COUNT(*) en SQL.

Dans cette section, vous allez apprendre à ajouter manuellement votre propre dimension au fichier de vue order_items.

Pour créer manuellement une dimension dans le fichier de vue order_items, procédez comme suit :

  1. Ouvrez le fichier quickstarts/order_items.view s'il n'est pas déjà ouvert : dans le panneau Explorateur de fichiers de l'IDE Looker, cliquez sur le dossier quickstart pour le développer, puis cliquez sur le fichier order_items.view pour l'ouvrir.
  2. Dans le fichier quickstarts/order_items.view, créez une ligne avant le premier paramètre dimension du fichier.

  3. Sur la nouvelle ligne, commencez à saisir dimension. À mesure que vous saisissez du texte, l'IDE Looker affiche une liste des paramètres possibles qui commencent par le texte que vous avez saisi.

    • Utilisez les touches fléchées pour parcourir la liste des suggestions jusqu'à l'option dimension.
    • Appuyez sur Entrée pour insérer le paramètre sélectionné dans votre code LookML. Looker insère un nouveau paramètre dimension sur la nouvelle ligne que vous avez créée.

  4. Pour donner un nom à la nouvelle dimension, cliquez dans l'IDE avant {} et saisissez shipped_to_delivered_days.

  5. Cliquez dans {} et appuyez sur Entrée pour créer une ligne dans {}.

  6. Complétez le code LookML pour la nouvelle dimension (vous pouvez copier et coller le code LookML suivant ou le saisir manuellement pour voir comment l'IDE Looker fournit des conseils) :

    dimension: shipped_to_delivered_days {
  group_label: "Other Dates"
  type: duration_day
  sql_start: ${shipped_raw} ;;
  sql_end: ${delivered_raw} ;;
}

  7. En haut de l'IDE Looker, cliquez sur le bouton Enregistrer les modifications.

Looker enregistre le fichier de vue avec votre nouvelle dimension. Pour les nouvelles lignes du fichier, l'IDE Looker affiche les numéros de ligne en vert.

Informations supplémentaires sur les champs LookML

Pour créer vos propres champs à l'avenir, consultez les ressources suivantes :

  • Pour en savoir plus sur les champs LookML en général, consultez la page de documentation Référence des champs LookML.
  • Pour en savoir plus sur les types de dimensions, de filtres et de paramètres que vous pouvez créer dans un fichier de vue, consultez la page de documentation Types de dimensions, de filtres et de paramètres.
  • Pour en savoir plus sur les types de mesures que vous pouvez créer dans un fichier de vue, consultez la page de documentation Types de mesures.

Afficher et tester vos modifications dans l'UI Looker

Si vous avez suivi la procédure Créer des explorations pour vos vues afin de créer une exploration pour le fichier de vue order_items, vous pouvez voir votre nouvelle dimension dans l'interface utilisateur de Looker Explore.

Pour afficher et tester vos modifications dans l'onglet "Explorer" de l'interface utilisateur Looker :

  1. Dans le fichier quickstarts/order_items.view de l'IDE Looker, cliquez sur l'icône en forme de flèche Afficher les actions du fichier à côté du nom du fichier de vue en haut du panneau de l'éditeur de fichier, puis sélectionnez l'option Explorer les articles commandés – quickstart_practice.

    Menu "Afficher les actions sur les fichiers", avec l'option "Explorer les articles commandés – quickstart_practice" sélectionnée.

  2. Dans le sélecteur de champ Éléments de la commande de l'exploration, cliquez sur le libellé du groupe Autres dates pour le développer, puis cliquez sur la dimension Jours entre l'expédition et la livraison pour l'ajouter à l'exploration. (Vous pouvez également rechercher la dimension en saisissant Shipped to Delivered Days dans le champ de recherche du sélecteur de champ.)

  3. Dans le sélecteur de champs Éléments de la commande de l'exploration, cliquez sur le libellé du groupe Date d'expédition pour le développer, puis cliquez sur la dimension Date pour l'ajouter à l'exploration.

  4. Dans le sélecteur de champs Explorer Éléments de la commande, cliquez sur le libellé du groupe Date de livraison pour le développer, puis cliquez sur la dimension Date pour l'ajouter à l'exploration.

  5. Cliquez sur le bouton Exécuter en haut de l'exploration.

Looker exécutera la requête et affichera les résultats dans la section Données de l'exploration. Pour chaque ligne, vous pouvez vérifier que la valeur Jours entre la date d'expédition et la date de livraison des articles de la commande indique le nombre de jours correct entre la valeur Date d'expédition des articles de la commande et la valeur Date de livraison des articles de la commande.

Valider votre code LookML

Pour ce guide de démarrage rapide, vous n'avez pas besoin de valider votre LookML. Toutefois, lorsque vous créerez vos propres projets pour modéliser vos données, il sera utile de connaître les outils Looker permettant de valider votre LookML.

Lorsque vous modifiez votre code LookML, l'IDE Looker vous avertit de toute erreur de syntaxe non résolue dans un fichier (consultez la page de documentation Présentation de l'IDE Looker). Vous pouvez également effectuer une validation complète du modèle, qui vérifiera si votre LookML contient des erreurs. Pour en savoir plus, consultez la page de documentation Valider votre LookML.

Valider vos modifications

Dans ce guide de démarrage rapide, vous utilisez une connexion Git préconfigurée pour l'exemple de projet LookML. Toutefois, à l'avenir, lorsque vous créerez vos propres projets pour modéliser vos données, vous devrez configurer une connexion Git pour votre projet.

Lorsque vous modifiez les fichiers de votre projet LookML, l'IDE Looker affiche différentes opérations pour le bouton Git en haut à droite de l'IDE. Le bouton affiche différentes opérations pour vous guider dans le processus de validation de votre LookML et de déploiement de vos modifications en production.

Les fichiers LookML et l'onglet Explorer que vous avez consultés dans ce guide de démarrage rapide ne sont disponibles que dans votre branche Git personnelle en mode Développement. Si vous souhaitez rendre ce modèle disponible pour d'autres utilisateurs de votre instance Looker (Google Cloud Core), vous devez valider vos modifications, fusionner votre branche et déployer la branche de production.

Pour les besoins de ce guide de démarrage rapide, vous ne déploierez pas vos modifications en production. À la place, vous supprimerez ces fichiers, comme décrit dans la procédure Nettoyer.

Effectuer un nettoyage

Pour maximiser les performances de Looker, les modèles inutiles ne doivent pas être déployés en production. Pour conserver une branche Git personnelle propre et éviter de déployer accidentellement ces fichiers en production, procédez comme suit pour supprimer les fichiers que vous avez créés dans ce guide de démarrage rapide :

  1. Cliquez sur l'icône Menu principal  de Looker, puis sélectionnez Développer si le menu Développer n'est pas déjà affiché.
  2. Dans le menu Développer, sélectionnez sample_thelook_ecommerce.
  3. Dans le panneau Navigateur de fichiers de l'IDE Looker, sélectionnez le menu à trois points Options du dossier pour le dossier quickstart que vous avez créé dans la procédure Créer un dossier de projet.
  4. Sélectionnez Supprimer dans le menu Options des dossiers.
  5. Dans la fenêtre Supprimer le dossier, cliquez sur Supprimer.

Looker supprime le dossier quickstart et tout son contenu.

Étapes suivantes