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 lui-même générer automatiquement des fichiers LookML basés sur les tables de votre base de données. Vous pouvez vous entraîner à le faire avec le guide de démarrage rapide Générer un modèle à partir d'exemples de données. Vous trouverez la procédure complète 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 d'exploration. Ce guide de démarrage rapide vous explique également comment activer le mode développement, naviguer dans 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 avez besoin des éléments suivants:

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 leur impact sur le contenu de votre instance sans affecter l'environnement de production (ce que les autres utilisateurs voient). 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 de 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. Activez l'option 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, interroger vos données et 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:

  1. Cliquez sur l'icône du 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 File Browser (Navigateur de fichiers) de l'IDE Looker et affiche les exemples de fichiers de projet LookML.

Créer un dossier de projet

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

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

  1. Dans le panneau File Browser (Navigateur de fichiers) de l'IDE Looker, cliquez sur l'icône Add file or folder (Ajouter un fichier ou un dossier) en haut du panneau, puis sélectionnez l'option Create Folder (Créer un dossier) dans le menu Add file or folder (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 File Browser (Navigateur de fichiers) de l'IDE Looker.

Informations supplémentaires sur les dossiers de l'IDE

Pour en savoir plus sur l'utilisation de 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 pour vos utilisateurs pour 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 File Browser (Navigateur de fichiers) de l'IDE Looker, sélectionnez le menu Folder Options (Options de dossier) à trois points pour le dossier quickstart que vous avez créé dans la procédure Créer un dossier de projet.
  2. Dans le menu Folder Options (Options des dossiers), sélectionnez Create Model (Créer un modèle).
  3. Dans la boîte de dialogue Create File (Créer un fichier), saisissez le nom quickstart_practice pour le nouveau fichier, puis cliquez sur Create (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 File Browser (Explorateur de fichiers) indique qu'il s'agit d'un nouveau fichier.
  4. Dans le panneau File Browser (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 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 tard dans ce 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 dans 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 le référencer dans d'autres parties de votre code LookML. Vous pouvez ainsi 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 le moyen le plus simple de commencer est de demander à Looker lui-même de générer automatiquement un fichier de vue basé sur un tableau existant dans votre base de données.

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

  1. Dans le panneau File Browser (Navigateur de fichiers) de l'IDE Looker, sélectionnez le menu Folder Options (Options de dossier) à trois points 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'un tableau dans le menu Options des dossiers.
  3. Sur la page Créer des vues à partir de tables, 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'à 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 "File Browser" (Navigateur de fichiers), le dossier quickstart est développé et le fichier de vue order_items est affiché 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 Looker IDE

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, vous devez vous familiariser avec la fonctionnalité d'aide rapide de l'IDE Looker. Le panneau Aide rapide fournit des explications et des options sur 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 affiche alors les options et 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 effectué 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 dans lequel 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 comment procéder.

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 : valeur, que vous pouvez sélectionner dans le champ none explore: order_items {}

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

Cette exploration est l'exemple le plus basique 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 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

Une fois que vous avez 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 le 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 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 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 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 totaux, etc. Une mesure est déclarée dans un fichier de vue et peut être de type agrégé ou non. 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 File Browser (Explorateur de fichiers) de l'IDE Looker, cliquez sur le dossier quickstart (Premiers pas) pour le développer, puis 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 commençant par le texte que vous avez saisi.

    • Utilisez les touches fléchées pour accéder à l'option dimension dans la liste des suggestions.
    • 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 le {}, puis 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 de la nouvelle dimension (vous pouvez copier-coller le code LookML suivant ou le saisir manuellement pour voir comment l'IDE Looker vous 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 Save Changes (Enregistrer les modifications).

Looker enregistre le fichier de vue avec votre nouvelle dimension. Pour vos nouvelles lignes dans le fichier, l'IDE Looker mettra en surbrillance 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'interface utilisateur de Looker

Si vous avez suivi la procédure Créer des explorations pour vos vues pour 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'interface utilisateur de 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 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 de commande - quickstart_practice.

    Menu "Afficher les actions sur le fichier", avec l'option "Explorer les articles de commande - quickstart_practice" sélectionnée.

  2. Dans le sélecteur de champ d'exploration Éléments de commande, cliquez sur le libellé de groupe Autres dates pour le développer, puis 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 champs.)

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

  4. Dans le sélecteur de champ de l'exploration Éléments de commande, cliquez sur le libellé de groupe Date de livraison pour le développer, puis 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 Jours entre la date d'expédition et la date de livraison des articles de la commande indique le nombre correct de jours entre la valeur de Date d'expédition des articles de la commande et celle de 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 est utile de connaître les outils Looker pour valider votre LookML.

Lorsque vous modifiez votre code LookML, l'IDE de Looker vous avertit de toute erreur de syntaxe non résolue dans un même fichier (voir la page de documentation Présentation de l'IDE de Looker). Vous pouvez également effectuer une validation complète du modèle, qui recherche les erreurs dans votre LookML. Pour en savoir plus, consultez la page de documentation Valider votre code 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 tout au long du processus de validation de votre 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 rendre ce modèle disponible pour d'autres utilisateurs de votre instance Looker (Google Cloud Core), vous devez commettre 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 allez plutôt supprimer ces fichiers, comme décrit dans la procédure de nettoyage.

Effectuer un nettoyage

Pour maximiser les performances de Looker, vous ne devez pas déployer de modèles inutiles 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, 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 File Browser (Navigateur de fichiers) de l'IDE Looker, sélectionnez le menu Folder Options (Options de dossier) à trois points 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 l'intégralité de son contenu.

Étape suivante