Modéliser vos données en LookML

LookML et l'IDE Looker vous permettent de définir des modèles de données, des dimensions et des relations réutilisables basés sur vos tables de base de données. Dans ce guide de démarrage rapide, vous allez créer un fichier de modèle et un fichier de vue, configurer une exploration et tester une nouvelle dimension à l'aide de l'exemple de projet LookML dans Looker (Google Cloud Core). Vous apprendrez également à activer le mode Développement, à naviguer dans l'IDE Looker et à utiliser l'aide rapide.

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 nécessaire pour accéder à l'application Looker (Google Cloud Core), demandez à votre administrateur de vous accorder le rôle IAM Utilisateur d'instance Looker (roles/looker.instanceUser) sur le projet Google Cloud qui contient 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 requise 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 : le mode Production et le 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 du menu principal de Looker  pour développer le menu de navigation principal, s'il n'est pas déjà développé.
  2. Sélectionnez le bouton d'activation 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 du menu principal de Looker  et 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 File Browser (Explorateur de fichiers) de l'IDE Looker et affiche les exemples de fichiers du projet LookML.

Créer un dossier de projet

Pour que les fichiers que vous créez dans ce guide de démarrage rapide soient séparés des autres fichiers de l'exemple de projet LookML, 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 Explorateur 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 de l'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 d'explorations Looker qui utilisent cette connexion. Une exploration est un point de départ pour que vos utilisateurs puissent 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 Explorateur de fichiers de l'IDE Looker, sélectionnez le menu à trois points Options du dossier pour le dossier quickstart que vous avez créé lors de la procédure Créer un dossier de projet.
  2. Dans le menu Folder Options (Options du dossier), sélectionnez Create Model (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 qu'il s'agit d'un nouveau fichier.
  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 n'est pas déjà ouvert.

Le fichier quickstart_practice.model contient un exemple de LookML que vous pouvez utiliser comme point de départ pour votre projet. Pour l'instant, vous pouvez conserver le fichier tel quel. Plus tard dans le guide de 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, notez 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 de base de données. 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 consiste à laisser Looker générer automatiquement un fichier de vue à partir d'une table existante de votre base de données.

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

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

  3. Sur la page Créer une vue à partir de la table, cliquez sur le champ de saisie Enter custom db (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'à 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 "Navigateur 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 les fichiers de vue

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

Aide rapide de l'IDE Looker

Vous avez maintenant 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 le code, vous devez vous familiariser avec la fonctionnalité d'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 alors les options et les sous-paramètres compatibles avec cet élément LookML.
  • Dans le panneau Aide rapide, vous pouvez cliquer sur le nom d'un paramètre pour ouvrir la page de la 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 d'exploration 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 référencer le fichier de vue dans la définition de l'exploration. Cette procédure vous explique en détail chacune 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, puis saisissez le code LookML suivant : 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 simple d'une exploration permettant aux utilisateurs d'interroger la vue order_items. À partir de là, vous pouvez développer votre exploration de différentes manières.

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, que les utilisateurs peuvent sélectionner dans le sélecteur de champs d'une exploration et qui peut être utilisé pour filtrer une requête. Si le champ ne se trouve pas dans une fonction d'agrégation telle que 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 basées sur le temps ou la durée en une seule fois. Par exemple, le groupe de dimensions d'une colonne de code temporel contiendra 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 temporels qu'il détecte dans votre table de base de données.
  • Une mesure est un champ d'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 de 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 Navigateur 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 de paramètres possibles commençant par le texte que vous avez saisi.

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

  4. Pour attribuer 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, notez 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'interface utilisateur de 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 l'exploration Looker.

Pour afficher et tester vos modifications dans l'exploration de l'UI Looker, procédez comme suit :

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

    Menu d'actions sur le fichier, avec l'option « Explorer les articles de la commande – quickstart_practice » sélectionnée.

  2. Dans le sélecteur de champs de l'exploration Order Items (Articles commandés), cliquez sur l'étiquette du groupe Other Dates (Autres dates) pour le développer, puis cliquez sur la dimension Shipped to Delivered Days (Nombre de 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 champs.)

  3. Dans le sélecteur de champs de l'exploration Order Items (Articles commandés), cliquez sur l'étiquette du groupe Shipped Date (Date d'expédition) pour la développer, puis cliquez sur la dimension Date pour l'ajouter à l'exploration.

  4. Dans le sélecteur de champs de l'exploration Order Items (Articles commandés), cliquez sur l'étiquette du groupe Delivered Date (Date de livraison) pour la 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écute la requête et affiche les résultats dans la section Données de l'exploration. Pour chaque ligne, vous pouvez vérifier que la valeur de Order Items Shipped to Delivered Days (Nombre de jours entre l'expédition et la livraison des articles de la commande) indique le nombre correct de jours entre la valeur de Order Items Shipped Date (Date d'expédition des articles de la commande) et celle de Order Items Delivered Date (Date de livraison des articles de la commande).

Valider votre code LookML

Pour les besoins de ce guide de démarrage rapide, vous n'avez pas besoin de valider votre LookML. Toutefois, à l'avenir, 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 code LookML.

Lorsque vous modifiez votre code LookML, l'IDE Looker vous signale 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 code LookML contient des erreurs. Pour en savoir plus, consultez la page de documentation Valider votre code LookML.

Validez vos modifications

Dans ce guide de démarrage rapide, vous allez utiliser 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.

À mesure que vous apportez des modifications aux 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 code LookML et de déploiement de vos modifications en production.

Les fichiers LookML et l'exploration 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 mettre ce modèle à la disposition 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. Vous supprimerez ces fichiers comme décrit dans la procédure Nettoyage.

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 du menu principal de Looker  et 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 Explorateur de fichiers de l'IDE Looker, sélectionnez le menu à trois points Options du dossier pour le dossier quickstart que vous avez créé lors de la procédure Créer un dossier de projet.
  4. Sélectionnez Supprimer dans le menu Options du dossier.
  5. Dans la fenêtre Supprimer le dossier, cliquez sur Supprimer.

Looker supprime le dossier quickstart et tout son contenu.

Étapes suivantes